Gmod Karma + Reputation System (FR) - Script

Description de Gmod Karma + Reputation System

1. 📘 Qu'est ce que Gmod Karma and Reputation System?
2. 📦 Contenue de Gmod Karma and Reputation System
3. ❓ À quel type de besoin peut répondre Gmod Karma and Reputation System?
4. ⚙️ Le panneau d'administration intégré
5. 🗃️ Database et gestion de la database intégré
6. 🔛 Options du système de Karma modulable
7. 🎨 HUD de la jauge de karma et de l'indicateur de réputation éditable.
8. ✔️ Compatibilité connu
9. 🧲 Symbiose entre les scripts existant
10. 🧩 Les API pour les devs

Gmod Karma and Reputation System ajoute un système de Karma et de Réputation pour votre serveur Garry's Mod (comme son nom l'indique). Il définit le rang de réputation d'un joueur en fonction de son niveau de points de Karma.

Ces points peuvent avoir une réelle signification pour les personnes et les communautés auxquelles elles participent. Mais aussi dans le jugement de l'équipe de modération et d'administration. En plus de pouvoir restreindre l'accès à certaines fonctions en fonction de la réputation gagnée ou perdue. Le karma reflète ce que l'utilisateur est réellement. Sauf dans le cadre d'un Roleplay qui permet de rappeler que le personnage joue un méchant.

Le système attribuera automatiquement des titres de distinction à un utilisateur en fonction de sa réputation qui évoluera en fonction de ses bonnes et mauvaises actions sur votre serveur, vous pouvez l'attribuer manuellement ou définir dans le panneau d'options les actes qui distribueront des points de karma en fonction des conséquences. Bien que cela soit modifiable, par défaut les points de karma vont de 0 à 1000. Vous pouvez créer autant de niveaux que vous le souhaitez, nommés par des titres. Par exemple, par défaut

100 points de karma = Très mauvaise personne (ou super mauvaise, vous pouvez les renommer comme vous le souhaitez)
400 points de karma = Mauvaise personne.
600 points de karma = Personne neutre.
750 points de karma = Bonne personne.
1000 points de karma = Très bonne personne.

Si vous voulez enlever ou ajouter des intermédiaires, c'est votre choix vous êtes libre.

Vous pourrez renommer ses niveaux et en ajouter pour qu'ils correspondent au thème de votre serveur Gmod. Vous pourrez également moduler les points qu'il faudra pour atteindre ses paliers. Les titres indiquant l'alignement de l'utilisateur sont distribués automatiquement en fonction du nombre de points de l'utilisateur. Des APIs existent pour les intégrer directement dans d'autres addons GMod et sont fournies dans la description et le Wiki.

Enfin, les actions ont des conséquences. Si vous ne l'utilisez pas pour enrichir l'histoire de votre serveur, vous pouvez l'utiliser comme un complément au système d'administration. Plus besoin de fouiller dans les logs pour trouver des preuves.

Pourquoi j'ai pensé à un système de karma ?
J'ai pensé que c'était une bonne idée parce que j'ai déjà codé un système de Karma au départ sur mon Gamemode pour mon serveur et qu'il m'a bien servi. Dans mon propre cas, j'avais plusieurs serveurs, un PvP et un PvE, mais il était impossible de faire respecter les règles PvE (joueurs contre environnement). Les joueurs PvP voulaient simplement tuer d'autres joueurs et étaient finalement bannis par l'équipe. Des règles renforcées n'ont jamais résolu ce problème et cela nécessitait beaucoup de présence. J'ai donc cessé d'appeler le serveur PvP et PvE et j'ai créé un système de karma qui me permettait de classer les joueurs PvP qui attaquaient les gentils dans la catégorie "Bandit" automatiquement lorsqu'ils tuaient des joueurs neutres et amis. Cela a permis aux joueurs PvE de se regrouper pour se défendre et de coopérer contre les joueurs qui étaient étiquetés comme bandits, car avant on ne pouvait pas savoir qui était bon ou mauvais, le bon joueur finissait par perdre son personnage parce que le mauvais avait été le premier à attaquer. Avec un système régi par le karma, les joueurs JcJ ont leur JcJ. Et les joueurs JcE peuvent éviter le combat ou s'entraider en formant des groupes de soutien. Et j'ai arrêté de bannir ceux qui tuent des joueurs sur les serveurs PvE, le bandit est devenu un élément du gameplay.
Ce genre de situation me concerne mais le fait que ce script soit conçu pour être modulaire et s'adapter à tous les gamemodes vous permettra de l'adapter à vos besoins à partir de l'interface d'administration incluse.

Le système peut être utilisé de deux manières. Soit de manière administrative et privée, il indique que le joueur n'est pas très bien intentionné car sa réputation est ternie par ses actions (ou amélioré).
Soit dans le RP ou le Lore, il permet de dire qui est du côté des bons ou des méchants.

Cerise sur le gateau, ce système permettra également de limiter l'accès aux métiers en fonction de la réputation de l'utilisateur. Par exemple, pour être policier, il faut avoir un certain niveau de Karma, sinon l'accès au poste sera refusé.

Vous pourrez également restreindre l'accès à mes marchands en fonction de leurs points de Karma (Scripts déjà compatibles dans le magasin indiqué en bas)

N'hésitez pas à consulter le wiki qui fournit des informations plus détaillées.

1. Une database qui permet de sauvegarder la réputation des utilisateurs, lorsqu'ils se reconnectent ils retrouvent leur réputation.
2. Un système qui permet de configurer la jauge de Karma affiché sur l'HUD et de le customiser.
3. Un système de module editable depuis le panneau de gestion qui permet de définir les règles du comportement du système de karma.
4. Un Système de gestion des Jobs et des Catégories de jobs qui permet de restreindre des accès en fonction du Karma requis.
5. Compatibilité avec différents scripts qui permet de définir des règles en fonction du karma de l'utilisateur et de faciliter la vie.
6. Panneau admin.

Vous avez besoin d'un système qui permet d'afficher la réputation d'un joueur en fonction de ses actes pour votre serveur Gmod.
Vous voulez que les points de réputation permet d'autoriser l'accès à des Jobs sur Gmod en mode DarkRP (Si le darkrp n'est pas installé cela concernera les :Team() à la place des jobs).
Vous souhaitez afficher les joueurs qui sont fiable et ceux qui ne le sont pas?
Vous souhaitez afficher les alignements des personnages Bon ou Mauvais.
Vous souhaitez abandonner l'idée de faire un serveur PvE ou PvP en créant un système de bandit et de joueurs friendly.
Vous souhaitez restreindre l'accès à une école dans Poudlard en fonction du karma de l'utilisateur afin que le chapeau ne face pas quelque chose d'aléatoire.
Vous avez besoin d'un outil d'administration qui vous permet de prendre des décisions plus juste lors du traitement d'un problème qui vise un utilisateur. Par exemple vous pourrez définir le système qui plainte visant un joueur qui a une mauvaise réputation n'est pas anodine. C'est à vous de voir comment vous allez utiliser ce système.

Vous avez la possibilité de tout gérer depuis une interface dont vous avez maintenant l'habitude de voir. Et de switcher entre toute les interfaces de mes différents système depuis les boutons raccourcies.
Depuis cette seule interface vous pourrez gérer la database, les jobs DarkRP (ou team), Les modules, et l'HUD.

La database permet de sauvegarder la réputation des joueurs ou de leur personnages.
Vous pourrez y régler manuellement les points de karma des joueurs qui définiront le titre de leur réputation si vous en avez le besoin de faire un système exclusivement manuel c'est possible, chaque option qui automatise la distribution des points de karma en fonction des actes de l'utilisateur est désactivable.

Le panneau de module vous permet d'activer et de désactiver une grande variété d'options. Les options désactivé ne sont pas dormante mais totalement inactive.
La liste des modules:
karma_start: Les nouveaux utilisateur arrive sur votre serveur avec ce karma
karma_restriction_job: Système de restriction de job en fonction du karma (Si DarkRP installé)
karma_account: ON= Réputation du compte. OFF= Du personnages (Character System)
karma_lost: Points de karma perdu quand un joueur meurt. 0=OFF
reward_karma_time: Les joueurs gagnent du karma en temps de jeu, en secondes. 0=OFF
reward_karma_points: Points de karma gagné par temps de jeu
jb_reward_timer: Boucle en seconde du système de point de karma d'un Job occupé. 0=OFF
karma_notif_change: Notifier l'utilisateur lorsque ses points de karma change
karma_chat_cmd: Activer la commande Chat: /rep ou /mykarma pour permettre de connaitre son rang
karma_npckill: Karma gagné quand le joueur tue un npc. 0=OFF
karma_pvpkill: Karma gagné quand le joueur élimine un autre joueur. 0=OFF
karma_teamkill: Karma perdu quand le joueur tue un joueur de la même équipe/job. 0=OFF
karma_badkill: Tuer un joueur qui a un bon Karma (>750) fait perdre des points de karma. 0=OFF
karma_goodkill: Tuer un joueur qui a un mauvais Karma (<400) donne des points de karma. 0=OFF

Vous avez la possibilité de rendre la jauge de Karma et le Titre de la réputation visible ou de le masquer via l'HUD qui offre 15 styles d'affichages plus ou moins discret sur l'HUD. La position, la taille, les couleurs et le format de texte affiché seront modifié à votre guise sans coder une seule ligne de Lua ou de GLua.

Les limitations de jobs par points de karma permettront par exemple de restreindre les jobs du DarkRP et ce syst ne rentreront pas en conflit avec BWhitelist, ni Nordahl Whitelist System.

Si vous vous demandez si mes scripts seront déjà compatible avec le Karma System à sa sortie. Oui ils le seront déjà.

Aucun de mes scripts ne sont des DLC. Chacun joue son rôle individuellement et tous peuvent fonctionner sans aucun Gamemode, lorsqu'on les met ensemble ont obtient une symbiose automatiquement prit en charge entre leurs fonctionnalités. Cela signifie que des fonctionnalités vont se compléter sans interférence. Et si cela est le cas le support technique consiste aussi à mettre à jours chaque scripts de Originahl Scripts.

Donc parmi les scripts déjà dans le store:
1. Possibilité d'afficher le karma et son rang uniquement dans l'inventaire de l'utilisateur pour ne pas l'afficher sur son HUD avec Gmod Advanced Inventory System
2. Possibilité de restreindre l'accès à un NPC marchand en fonction du nombre de point de karma de l'utilisateur. Cela concerne le Gmod Items Bank et le Gmod Items Dealer.
3. Possibilité d'afficher le titre karma de l'utilisateur dans le Scoreboard avec Gmod Scoreboard Modulable
4. Possibilité de configurer des gains et des pertes de karma précis lorsqu'on tue des NPCs avec Gmod NPC Reward Manager par exemple si vous tuez telle NPC vous perdez des points de karma. Si vous tuez celui un autre vous pourrez faire gagner des points de Karma.

player:Karma() -- Retourne le nombre de points de karma de l'utilisateur. (Client + Server)
player:GetMaxKarma() -- Retourne le karma maximum. (Client + Server)
player:GetKarmaRank() -- Retourne le nom du titre de réputation. (Client + Server)
player:addKarma(add,text) -- Permet d'ajouter et de retirer des points de karma. Fonctionnant avec les valeurs numétique positives et négative. (Server)
player:setKarma(add) -- Permet d'attribuer directement le nombre de points de karma de l'utilisateur. (Server)