NRank - Gmod's Advanced Customisable Ranking System (FR) - Script

Description de NRank - Gmod's Advanced Customisable Ranking System

1. ℹ️ Description du script: NRank - Gmod's Advanced Ranking System
2. 🧰 Création et configuration des grades en temps réel et de leurs insignes
3. 🧚🏻 Attribution automatisé des playermodel / Skin / Bodygroup / Couleur, lorsqu'un utilisateur obtient un insigne
4. 🎨 Personnalisation de l'affichage des rangs et de leur progression sur HUD 2D et/ou 3D
5. 💬 Différentes méthode pour obtenir / donner un grade, promouvoir ou rétrograder un utilisateur
6. 💾 Panneau de gestion de la base de données MySQL de NRank
7. 🕗 Système d'expiration des grades et d'auto maintenance
8. 👑 Panneau d'administration, de gestion complet, fluide et intuitif
9. ⚙️ Panneau de gestion des modules permettant d'activer ou de désactiver des options supplémentaires
10. 📚 Menu wiki des grades pour les joueurs (Système d'information des grades existants sur votre serveur)
11. 👁️ Un système d'ESP Admin / Team permettant de visualiser les badges sur la carte
12. 🧩 Scripts déjà compatibles exploitant les API de NRank automatiquement
13. 💻 Les API de NRank pour les développeurs et son intégration dans des scripts tiers
14. ⚡ Optimisation complète du système de rang
15. ⭐ Système de Rang et de progression de rang alternatif 5 étoiles à NRank
16. 💡 Des univers à alimenter et des idées de grades sur NRank, avec DarkRP ou sans DarkRP

NRank offre une solution complète pour la gestion avancée des grades sur votre serveur Garry's Mod. Grâce à la création et à la configuration en temps réel des grades et de leurs insignes, les administrateurs peuvent personnaliser chaque aspect, des conditions d'obtention des grades aux playermodels, skins et couleurs uniques associés à chaque rang. Le système de liaison de playermodels et skins permet une personnalisation poussée de l'apparence des joueurs en fonction de leur grade, renforçant ainsi leur immersion dans le jeu. De plus, le système de promotion automatique via l'expérience des grades et la gestion efficace des membres facilitent la gestion de la communauté. Enfin, NRank offre une intégration fluide avec d'autres addons tiers et des scripts compatibles, garantissant une expérience de jeu harmonieuse et cohérente pour les joueurs.

Bien qu'il soit possible d'associer un Job DarkRP ou une catégorie de job à l'auto-assignation d'un grade, l'addon peut également fonctionner sans DarkRP. NRank n'est pas dépendant de DarkRP pour son fonctionnement, ici le DarkRP est simplement une option. Si vous choisissez de quitter DarkRP un jour, NRank continuera de fonctionner correctement, même sans ce mode de jeu.

NRank permet aux administrateurs ou au chef de la hiérarchie (option faculative) de créer et de configurer des rangs en temps réel, y compris la personnalisation des insignes, les conditions d’obtention d'un grade (level du joueur, réputation, nombre de points d'expérience de rang requis pour passer au rang suivant), les droits, les accès, le playermodel associé à un grade, des skins, des bodygroups et des couleurs uniques, voir le wiki du produit pour plus de détails.

Un Système de Liaison de Playermodel, Bodygroup et Skin: Avec NRank, les administrateurs peuvent lier des playermodels, skins et bodygroups à des grades spécifiques, offrant ainsi une personnalisation encore plus poussée de l'apparence des joueurs en fonction de leur grade. Cette fonctionnalité permet de renforcer l'immersion des joueurs en leur offrant des identités visuelles uniques selon leur progression dans le jeu et leur grade.

Un HUD 2D et 3D Personnalisable: Grâce à NRank, les administrateurs peuvent personnaliser l'HUD en temps réel pour afficher les insignes des grades à la fois en 2D et en 3D, ainsi que désactiver complètement l'affichage si nécessaire. Les options de personnalisation incluent la taille, la position, le style des insignes, ainsi que l'affichage du nom du grade, offrant une expérience visuelle unique et adaptable selon les préférences du propriétaire du serveur. Cette personnalisation étendue crée une immersion pour les joueurs et renforce l'identité visuelle du serveur, tout en réduisant les coûts et les risques (Scam sur Discord, Job insatisfaisant) associés à l'embauche de développeurs tiers/inconnu pour des modifications.

1. La personnalisation de l'affichage sur l'HUD 2D:
- Afficher la progression du grade en % ou en indiquant la progression des EXP de grade par rapport au point d'expérience requis pour être promu automatiquement au grade suivant, si vous optez pour un système moins automatisé comme la promotion uniquement par job DarkRP ou manuel, vous aurez la liberté de désactiver l'affichage de la progression (ON|OFF).
- Afficher le nom du joueur sur l'HUD 2D (ON|OFF).
- Afficher le titre du grade sur l'HUD 2D (ON|OFF).
- Désactiver l'HUD 2D quand le joueur n'a pas de grade (ON|OFF).
- Viser le joueur pour afficher son grade sur l'HUD 2D (ON|OFF).
- Modifier la couleur du fond de la zone d'affichage du rang et de son insigne.
- Modifier la couleur du texte de l'affichage sur l'HUD 2D
- Désactiver completement l'HUD 2D. (La progression s'affiche aussi dans mon système d'inventaire et mon Character System)

2. Personnalisation de l'Affichage sur l'HUD 3D: De la même manière, l'affichage des grades sur l'HUD 3D peut être personnalisé selon les préférences des administrateurs, offrant une liberté visuelle accrue pour les joueurs:
- Vous aurez la possibilité de désactiver l'HUD 3D selon vos propre choix (ON|OFF).
- Afficher les insignes de tout le monde (ON|OFF).
- Afficher seulement les insignes sur les joueurs (ON|OFF).
- Afficher le nom du grade du joueur visé seulement. Au bout d'un moment quand tout le monde connait les insignes il est inutile de sature l'affichage. D'autant plus que le script inclut une base de connaissance des insignes existant sur le serveur (ON|OFF).
- Afficher le nom du joueur sur l'HUD 3D (ON|OFF).
- Désactiver l'HUD 2D quand le joueur n'a pas de grade (ON|OFF).
- La taille de l'insigne au dessus des têtes.

Il existe donc plusieurs manière d'afficher et de connaitre le rang d'un joueur se trouvant en face, à vous de choisir.

La promotion automatique via le système d'expérience des grades inclut :

Grâce au système de gain d'expérience passive par temps de jeu, un joueur occupant un grade gagnera des points d'expérience de manière passive. Lorsque le seuil maximum d'expérience est atteint, le joueur passe automatiquement au rang suivant. Vous pouvez désactiver l'expérience passive manuellement depuis le panneau de gestion sans avoir besoin de connaissances en programmation Lua ou GLua.

Vous pouvez également promouvoir un joueur manuellement, soit en tant qu'administrateur, soit en tant que membre ayant les permissions définies par l'administrateur dans le menu de gestion et de création de grades de NRank.

De plus, le temps et le gain d'expérience sont configurables depuis le menu de gestion.

Une fois que vous avez les autorisations nécessaires, vous aurez plusieurs façons de mettre à niveau un membre de votre groupe :

- Par la commande de chat /promote et /demote sur un joueur que vous regardez.
- Si vous utilisez mes scripts, tels que le système de chat, le grade s'affichera à côté des messages des utilisateurs. En cliquant dessus, vous aurez la possibilité de le promouvoir/rétrograder sans chercher.
- Via mon système d'administration depuis la gestion des joueurs, l'option apparaîtra en cliquant sur la ligne du joueur en ligne.
- De même, via mon système de scoreboard personnalisable, le rang s'affichera à côté du nom des joueurs automatiquement, et en cliquant sur l'insigne du grade dans n'importe quel autre de mes scripts, l'option de promotion ou de rétrogradation vous sera proposée.

Si vous utilisé le DarkRP (ou NJob) vous pourrez associer un grade à un job ou une catégorie de job depuis la configuration du Grade. Il suffira seulement de mettre le nom du job ou de la catégorie. Une fois que le joueur obtient le job, il obtiendra alors le grade. Ce n'est qu'une option falcultative.

L'idée est d'exploiter mes API que j'ai créées dans NRank dans mes autres scripts pour simplifier l'usage et de fournir une démonstration des associations possibles avec d'autres scripts qui fonctionnent déjà dès la sortie du produit.

Gestion Efficace des Membres : Avec NRank, la gestion des membres est simplifiée. Les administrateurs peuvent facilement promouvoir, rétrograder ou exclure des joueurs en fonction de divers critères propres à votre projet, tels que leur comportement ou leur contribution au serveur ou au groupe, assurant ainsi un environnement de jeu hiérarchisé très demandé dans le RP. Le système de leveling et de réputation (Karma), facultatif, permet de poser des restrictions d'accès en fonction du niveau et de la réputation des joueurs, renforçant ainsi la gestion communautaire. De plus, NRank offre la possibilité de configurer ces paramètres de manière flexible via un panneau de gestion intuitif, garantissant une adaptation optimale aux besoins spécifiques de votre communauté.

NRank propose un système d'expiration des grades et d'auto-maintenance, permettant de retirer automatiquement les grades aux joueurs inactifs pendant une période définie par les administrateurs. Il permet également d'affecter un grade pour une durée déterminée ; par défaut, la durée est indéterminée. Il sera possible de voir dans le menu de gestion la liste de tous les joueurs ayant un grade et leur temps d'expiration, le cas échéant.

Grâce à un panneau d'administration fluide et intuitif, les administrateurs ou les gradés peuvent effectuer toutes les actions nécessaires pour gérer les grades, les utilisateurs et les paramètres de NRank avec facilité. Ce panneau offre une expérience utilisateur optimale, permettant une navigation aisée et une prise en main rapide des fonctionnalités de gestion.

Les utilisateurs qui ne sont ni administrateurs ni gradés et qui accèdent au panneau ne verront que la liste des grades existants sur votre serveur. Il devient alors un panneau d'information affichant tous les grades existants sur votre serveur, listés avec leurs insignes associés, leur nom et leur niveau hiérarchique.

NRank offre un panneau de gestion des modules dans son menu, permettant aux administrateurs de personnaliser les fonctionnalités et les extensions du système selon leurs besoins spécifiques. Grâce à des boutons intuitifs, vous pouvez facilement activer ou désactiver les options nécessaires, et chaque variable est clairement décrite depuis le panneau.

Voici un aperçu des options disponibles:

mod_xptime : Active le système d'XP passive pour automatiser la progression des grades. (Durée de la boucle en secondes. 0 = OFF).
mod_activity_xp : Gain d'EXP par loop (quantité).
mod_deathreset : La progression du grade tombe à zéro si le joueur meurt (ON|OFF).
mod_deathrklost : Si le joueur meurt, il sera rétrogradé (ON|OFF).
mod_chatcmd : Commande chat : /NRank pour ouvrir le menu NRank (ON|OFF).
mod_chatpromot : Commande chat : /NPromote pour promouvoir un joueur visé (si l'utilisateur a le pouvoir de promouvoir) (ON|OFF).
mod_chatdemot : Commande chat : /NDemote pour rétrograder un joueur visé (si l'utilisateur a le pouvoir de rétrograder) (ON|OFF).
mod_getxp_notif : Notifier dans le chat quand on gagne de l'EXP de progression de grade (ON|OFF).
auto_assign : Les nouveaux utilisateurs qui arrivent sans grade sont automatiquement assignés au premier grade d'une catégorie de manière aléatoire (ON|OFF).
mod_db_clean1 : Maintenance automatique : Suppression automatique des grades expirés (ON|OFF).
mod_db_clean2 : Suppression automatique des joueurs inactifs de la base de données (nombre de jours d'inactivité).
mod_rem_rank : Supprimer le grade et la progression lorsque le joueur change de job pour une autre catégorie de job (DarkRP ou NJob System) (ON|OFF).

Hiérarchie Clair et Compréhensible : Grâce à NRank, les joueurs ont accès à une base de connaissances claire répertoriant tous les grades et leurs autorisations respectives. Cela leur permet de comprendre aisément la structure hiérarchique du serveur, favorisant ainsi l'information, la communication et la collaboration au sein de la communauté. De plus, un panneau affichant l'ensemble des grades dans l'ordre hiérarchique est disponible, offrant aux joueurs la possibilité de s'informer de manière autonome.

L'utilisateur aura donc la possibilité de voir ce tableau des grades, l'administrateur pourra également ouvrir ce tableau chez l'utilisateur qui le demande.

Le système d'ESP Admin (Extra Sensory Perception) permet aux administrateurs d'activer une vision générale de chaque emplacement des joueurs gradés et non gradés à travers la carte. Cette fonctionnalité offre aux administrateurs un aperçu de la position de chaque joueur, facilitant ainsi la surveillance et la gestion de l'activité des joueurs sur le serveur.

Aucun de ces scripts n'est obligatoire, ils fonctionnent de façon indépendante les uns des autres. Ils sont facultatifs et s'adaptent à vos besoins.

- Gmod Scoreboard /Tabmenu Editable: Dans le tableau des scores, les grades des joueurs se révèlent, témoignant de leurs compétences et de leur détermination. Explorez la diversité des rangs alors qu'ils s'affichent avec élégance à côté des noms des joueurs, offrant un aperçu instantané de leur statut et de leur expérience.

- Gmod Advanced Chat Multi-channel: Dans le chat, les grades des joueurs ajoutent une dimension supplémentaire à l'interaction. Découvrez la diversité des rangs alors qu'ils s'affichent fièrement à côté des noms des joueurs. Cliquez sur le grade du joueur de votre catégorie si vous en avez le pouvoir pour le promouvoir ou le rétrograder.

- Gmod Advanced Character Creator System: Chaque personnage possède son propre grade distinct avec mon Character System, apportant sa propre couleur et sa propre perspective à l'histoire. Explorez les multiples facettes de ces personnages, chacun portant fièrement son propre emblème, sa propre essence, et ensemble, tissant une toile fascinante de diversité et de complexité. Chaque personnage aura sa propre progression, vous encourageant ainsi à tester d'autres factions, guildes ou métiers.

- Gmod Advanced Inventory System: Si vous souhaitez ne pas afficher les grades sur l'HUD, vous pouvez toujours consulter ces informations dans l'interface de l'inventaire. Certains préféreront alléger l'HUD, c'est une option alternative. Le joueur peut ouvrir son inventaire pour voir son grade dans son panneau d'informations.

- Nor Admin Mod for GMod: Centralisez toutes vos opérations de gestion de grades dans un seul endroit, éliminant ainsi les tracas liés à la navigation entre plusieurs interfaces depuis le panneau d'administration. Avec Nor Admin Mod, vous pouvez naviguer sur toutes les interfaces de mes différents produits à partir d'un seul menu.

- Gmod Leveling System: Créez des conditions pour l'obtention d'un grade en fonction du niveau de l'utilisateur dans la conception du grade.

- Gmod Karma and Reputation System: Créez des conditions pour l'obtention d'un grade en fonction de la réputation et du karma du joueur dans la configuration du grade.

Compatibilité avec les Addons Tiers: NRank est conçu pour être compatible avec les addons tiers populaires, offrant ainsi une flexibilité maximale aux administrateurs de serveur pour intégrer des fonctionnalités supplémentaires.
Les API fournies permettent une intégration fluide avec d'autres extensions, garantissant une expérience de jeu harmonieuse et cohérente pour les joueurs. Ses API sont déjà exploité dans tout mes scripts compatible:

CLIENT and SERVER SIDE:
player:GetUserNRank() -- Retourne le nom d'un grade. Utilisé pour l'indexation.
player:GetUserNRankName() -- Retourne le nom friendly d'un grade.
player:GetNRankGroup() -- Retourne le nom de groupe d'un grade.
player:GetEXPNRank(xp) -- Retourne les points d'expérience nécessaires pour occuper un grade.
player:GetMaxEXPNRank() -- Retourne le seuil maximum d'expérience à atteindre pour passer au grade suivant.
player:GetNRankLvL() -- Retourne le niveau hiérarchique d'un grade.

SERVER SIDE:
player:SetUserNRank(rank, save, by) -- Permet d'attribuer un rang sans condition. rank = Nom du rang, save = Booléen pour forcer la sauvegarde, by = Chaîne de caractères pour enregistrer la source (par exemple, si la fonction est lancée par le système, le gamemode, un autre addon, ou le nom d'un utilisateur via le panneau d'administration).
player:SetEXPNRank(xp, bool) -- Définit les points d'expérience du rang occupé.
player:addRKXP(xp) -- Ajoute des points d'expérience pour la progression du rang.
player:PromotUserNRank() -- Permet de promouvoir le grade de l'utilisateur.
player:DemotUserNRank() -- Permet de rétrograder le grade de l'utilisateur.
player:NRankAutoAssign() -- Permet d'assigner un grade aléatoirement à un joueur.
player:NRankIsAbove(rank) -- Vérifie si le rang est supérieur.
player:UserPromotUserNRank(target) -- Permet de promouvoir une cible (fonctionne si les conditions requises sont atteintes).
player:UserDemotUserNRank(target) -- Permet de rétrograder une cible (fonctionne si les conditions requises sont atteintes).

Le script a été pensé pour un poids minimal, l'addon tient dans 3 fichiers:
Un fichier configuration de 12ko,
Un fichier lua client de 63 ko,
Un fichier lua serveur de 32 ko.

Les ressources matériel envoyé sur le workshop de steam est de 20.3 KB.

NRank ne fera pas partie des scripts qui ajouteront du temps de chargement à votre serveur.

1- MRS - Advanced Rank System (Gmodstore)

Le script est entièrement personnalisable, explorez une multitude d'univers dans votre serveur et ou laissez libre cours à votre imagination !
Quelques exemple de grade que vous pourrez faire avec NRank:
Naruto - Hokage, Jounin, Chunin, Genin
Medieval - King, Knight, Squire, Peasant
Star Wars - Jedi Master, Sith Lord, Bounty Hunter, Stormtrooper
Clone Wars RP - Jedi Council, Clone Commander, Clone Trooper, Separatist Leader
Anim RP - Alpha, Beta, Gamma, Omega
Harry Potter - Headmaster, Professor, Prefect, Student
Zombie Apocalypse - Survivor, Scavenger, Leader, Zombie
Cyberpunk - Corporate Executive, Hacker, Street Samurai, Netrunner
Wild West - Sheriff, Outlaw, Gunslinger, Prospector
Superhero - Superhero, Sidekick, Villain, Civilian
Pirates - Captain, First Mate, Swashbuckler, Deckhand
Ancient Egypt - Pharaoh, High Priest, Soldier, Peasant
Fantasy - Wizard, Warrior, Ranger, Rogue
Post-Apocalyptic - Warlord, Survivor, Raider, Mutant
Fairy Tale - Prince/Princess, Witch, Knight, Peasant
Mythological - God/Goddess, Hero, Monster, Mortal
Samurai - Daimyo, Ronin, Samurai, Peasant
Space Exploration - Captain, Engineer, Scientist, Alien
Spy - Agent, Handler, Double Agent, Analyst
Western - Marshal, Gunslinger, Gambler, Saloon Owner
Martial Arts - Sensei, Disciple, Fighter, Monk
Victorian Era - Aristocrat, Servant, Detective, Inventor
Futuristic City - Megacorp CEO, Cyborg, Hacker, Citizen
Dystopian Society - Elite, Rebel, Worker, Outcast
Jurassic Park - Park Warden, Paleontologist, Visitor, Dinosaur
Game of Thrones - King/Queen, Lord/Lady, Knight, Peasant
Mythical Creatures - Dragon, Phoenix, Unicorn, Werewolf
Survival Island - Castaway, Tribal Chief, Explorer, Cannibal
Ancient Rome - Emperor, Senator, Gladiator, Slave
High School - Principal, Teacher, Student Council, Student.