WJob - Gmod Whitelisting Job System 2 (FR) - Script

Description de WJob - Gmod Whitelisting Job System 2

1. 📘 Qu'est-ce que WJob - Gmod Whitelisting Job System 2?
2. ✔️ Pré-requis
3. 📕 Présentation du panneau d'administration
4. 🟢 Gestion des utilisateurs connecté
5. 💾 Système de sauvegarde des whitelists des utilisateurs
6. 🔬 Gestion et contrôle de la database clair et optimisé
7. ⏰ Système d'expiration des ajouts dans la database
8. 💼 Activer la liste blanche des jobs ou des groupes de jobs sans redémarrage
9. 🧰 Les options d'un job ou d'une catégorie de job
10. 🔒 Système de restriction d'accès par job personnalisable en temps réel
11. ⚙️ Options serveur de WJob - Gmod Whitelisting Job System 2
12. 🔔 Système de notifications fluide et traduit
13. 🔌 API
14. ⚡ Optimisation du système et des fichiers
15. 🧩 Addons Gmod compatibles avec WJob - Whitelist Job System

WJob - Gmod Whitelisting Job System 2 pour DarkRP ou NJob vient 10 ans après la sortie de ma première Whitelist Job System sur Gmodstore qui était aussi la première Whitelist de GMod. WJob - Gmod Whitelisting Job System 2 est un nouveau système complet parti de Zéro, avec lequel je comble tous les défauts de mon ancien système et qui apporte encore plus de fonctionnalité pour un système extrêmement plus optimisé et beaucoup plus d'ergonomique, j'exagère pas si je dirais qu'il n'y aura pas besoin de documentation pour pouvoir l'utiliser, ni besoin de compétences en Lua.

Les jobs de votre serveur sont classé par groupes et vous pouvez les dérouler, activer la whitelist pour tout le groupe de job ou activer la whitelist pour les jobs individuellement, ils sont affiché en gris dans la liste quand les jobs ne sont pas soumis à la whitelist. Vous cliquez dessus et hop c'est activé, il devient blanc avec un petit logo de whitelist, le système offre aussi une Blacklist et divers système de restrictions de Job. Il permettra aux joueurs de ne pas acceder à certains jobs si ils y sont interdit.

Une symbiose avec les addons que j'ai déjà créé permettront d'enrichir les conditions, par exemple avec le système de réputation et de Karma vous pourrez limiter l'accès à un job en fonction de la réputation d'un joueur sur votre serveur ou de son personnage.

Le tout tient dans un petit fichier client de 44ko et un fichier serveur de 19ko. Ne jugez pas un addon à la taille de ses fichiers. Le Gamemode Zworld Afterlife en est la preuve.

Pré requis: Il vous faut au minimum un DarkRP (ou MilitaryRP, AnimRP, MangaRP, StarwarsRP, CloneRP, n'importe quel de ses derive) ou
si vous n'avez pas le DarkRP vous pouvez mettre à la place l'addon NJob - Gmod Job Creator and Editor qui est plus optimisé qui ajoute un système de job configurable in game à votre serveur sans faire trop d'effort.

Vous n'avez besoin d'aucune base de connaissance en Lua pour utiliser WJob.

Le panneau d'administration de WJob est un outil centralisé permettant une gestion efficace des accès aux différents jobs du serveur. Il offre des fonctionnalités telles que l'ajout de joueurs aux whitelists ou blacklists, l'activation ou la désactivation des accès, et la configuration de conditions spécifiques d'accès basées sur le temps, la réputation, ou d'autres critères.

L'accès peut se faire via plusieurs méthode, par commande /wjob ou /whitelist.
Par bouton raccourcie comme F3 par exemple.
Par mon système d'administration Nor Admin Mod.

Les joueurs ne disposant pas de tous les droits ne verront que les options avec lesquelles ils peuvent interagir.

Depuis le menu de gestion, vous avez la possibilité d'ajouter des joueurs aux whitelists des différents jobs ou groupe de job si les conditions requises le permettent. Pour cela, il est nécessaire de disposer des rangs d'administration adéquats ou que le job du joueur bénéficie des autorisations que vous avez préalablement définies dans le menu.

La gestion des utilisateurs peut être effectuée via plusieurs interfaces : mon système de chat, mon tableau de scores (scoreboard), mon système d'administration, ou directement via le menu en utilisant la commande /whitelist. Cette flexibilité permet une administration efficace et adaptée aux besoins de votre serveur.

Les modifications apportées aux accès aux jobs sont sauvegardées en temps réel, garantissant que lorsque le joueur revient, il retrouvera ses accès aux jobs qu'il avait précédemment. Vous avez également la possibilité de désactiver cette fonctionnalité pour certains jobs si nécessaire. De plus, il est possible d'ajouter une durée d'expiration aux accès, permettant ainsi de limiter temporairement l'accès à certains jobs selon les besoins du serveur ou les préférences de gestion.

La gestion de la base de données est conçue pour être claire et intuitive. Les lignes affichées comprennent le type d'entrée (Whitelist, Blacklist, Full Access), le groupe de job ou le job spécifique (par exemple, Citizens / Mayor / Full Access), le temps de connexion de l'utilisateur, la date depuis laquelle il est whitelisté, et cruciallement, le temps d'expiration qui indique si l'ajout à la whitelist d'un job est permanent, en cours ou expiré. De plus, chaque ligne révèle qui a ajouté l'entrée, que ce soit via une commande console (typiquement dans le cadre d'un système de dons), par le système lui-même ou par un utilisateur.

Un système de recherche complet est également intégré. Il permet de retrouver une entrée spécifique par SteamID, par nom d'utilisateur, ou par job, rendant ainsi la navigation et la gestion des données efficace et rapide.

Vous aurez la possibilité de déterminer si l'ajout à la whitelist (ou à la blacklist) est permanent ou temporaire en attribuant une durée d'expiration spécifique. Vous pouvez également opter pour une option éphémère, valable uniquement pour la session en cours. Ainsi, si la durée d'accès à un job est limitée, une fois ce temps écoulé, l'utilisateur ne pourra plus y accéder.

Activer la whitelist pour un job est extrêmement simple. Commencez par ouvrir le menu WJob, puis naviguez vers la gestion des whitelists. Vous verrez alors s'afficher la liste des jobs, classés par groupe, de votre serveur. Sélectionnez l'job de votre choix en cliquant dessus ; une fenêtre s'ouvrira pour vous demander si vous souhaitez activer la whitelist pour cet job. Une fois confirmé, l'activation est immédiate. Les options de configuration et les restrictions applicables à cet job apparaîtront ensuite sur le côté droit de l'écran. Pour supprimer un job, faites un clic droit sur celui-ci.

Le système de whitelist permet un contrôle précis des joueurs pouvant accéder à un job mais pouvant aussi le gérer s'ils ont le job qui l'autorise. Plusieurs options de configuration sont disponibles pour l’adapter à vos besoins : il est possible d’activer ou de désactiver la whitelist et la blacklist indépendamment. Vous pouvez limiter le nombre de joueurs whitelistés (0 signifiant illimité) et choisir si la whitelist est conservée après une déconnexion ou si les joueurs y sont retirés automatiquement une fois le job obtenu. Les permissions peuvent être ajustées, notamment pour permettre ou restreindre la gestion et la modification des whitelist et blacklist par certains utilisateurs qu obtiennent le job, ainsi que l'accès à la base de données des joueurs se trouvant dans la même catégorie de job. Enfin, des restrictions spécifiques peuvent être appliquées pour interdire la consultation ou la modification des données liées à d'autres catégories de jobs, les joueurs ayant le droit de voir la liste de whitelist de sa categorie de job ne verront pas celle des autres categories.

L’accès à un job peut être configuré selon divers critères pour répondre à des besoins spécifiques. Un niveau requis ou une réputation minimale peuvent être définis (par défaut à 0, aucune exigence). L’accès peut également être limité aux membres VIP ou au Staff, selon les réglages. Une restriction par catégorie peut être activée, obligeant les joueurs à occuper un job de la même catégorie avant d’accéder à celui-ci. Des conditions temporelles précises peuvent aussi être appliquées : le job peut être accessible uniquement le weekend (temps réel), uniquement la nuit ou uniquement le jour (temps en jeu), pour des scénarios spécifiques ou immersifs.

Les options du serveur et les paramètres généraux offrent la possibilité de personnaliser des aspects clés de la gestion des jobs en activant ou désactivant des fonctionnalités via des interrupteurs ON/OFF. Chaque option est clairement expliquée pour faciliter sa compréhension. Il est possible de désactiver simultanément la whitelist et la blacklist pour tous les jobs, ce qui centralise le contrôle de l’accès. La fonction d’auto-maintenance de la base de données est conçue pour supprimer automatiquement les joueurs inactifs après une période prédéfinie, par défaut fixée à 60 jours. Les commandes de chat telles que /WJob ou /whitelist ouvrent le menu de gestion de la whitelist pour le staff et les joueurs ayant certains droits grâce à leur job occupé. Des notifications peuvent être activées pour suivre les événements de manière globale via la console, tandis que des alertes sur l'interface utilisateur informent directement les joueurs des raisons du refus d’accès à un job. En outre, une gestion de la whitelist par personnage est disponible pour les serveurs utilisant le système de personnage avancé (Gmod Advanced Character Creator System), permettant une gestion d'accès individualisée par personnage que possède un joueur. La base de données offre également la possibilité de configurer l'affichage d'un nombre spécifique de lignes par page pour une navigation optimisée.

Lorsque le joueur rencontrera une restriction, un message clair et discret apparaîtra sur l'interface utilisateur pour expliquer la raison pour laquelle il ne peut pas accéder à un job. Ce message sera visible sans être envahissant et ne s'accompagnera d'aucun effet sonore intrusif ou désagréable.

Les API permettent une intégration aux autres addons, si vous avez besoin de plus, n'hésitez pas à faire la demande:

player:WJobCheckAccess(access_id) -- Permet de vérifier les autorisations d'un utilisateur.
player:IsWhitelisted(team_id) -- Permet de checker si l'utilisateur est whitelisté pour ce job.
player:IsBlacklisted(team_id) -- Permet de checker si l'utilisateur est blacklisté pour ce job.

La base de données est désormais gérée en SQL, offrant une flexibilité accrue et des performances nettement supérieures par rapport à l’ancien système basé sur des fichiers texte. Grâce à cette amélioration, le personnel n’a plus besoin de télécharger inutilement l’intégralité des données ce qui soulagera le CPU de votre serveur.

WJob a été conçu pour être l'un des systèmes de whitelist job les plus optimisés pour Garry’s Mod, tout en restant extrêmement léger. Il se compose uniquement de trois fichiers.
Taille du dossier Lua (version 1.0):

Client : 44 Ko
Serveur : 19 Ko
Configuration : 9 Ko
Ressource Workshop : seulement 7 Ko.

Ce design minimaliste contribue à réduire le temps de chargement pour vos joueurs, offrant une expérience fluide et performante.

Aucun de ces addons n'est obligatoire, chacun peut fonctionner indépendamment des autres. Je garantis simplement leur compatibilité et des fonctionnalités supplémentaire s'ils sont installé ensemble.

1. Norda Advanced leveling system: Une excellente alternative à Vrondakis, avec support, mise à jour régulière, et panneau de gestion de la base de données et des réglages.

2. Système de Réputation et de Karma: Permet de restreindre l'accès aux jobs en fonction du niveau de réputation du joueur (Bonne personne / Mauvaise personne).

3. Système d'administration Nor Admin Mod: Offre un système d'administration optimisé et un système de statut VIP pour les fonctions Premium de votre serveur.

4. DarkRP F4 Customizable menu: Le Norda F4 Menu est adapté aux nouveautés contenues dans NJob ou au DarkRP.

5. Norda Gmod Scoreboard Editor: Permet d'avoir un scoreboard entièrement éditable et de gérer les attributions des whitelists de jobs aux joueurs à partir de celui-ci, que vous soyez admin ou un job ayant le pouvoir d'ajouter les joueurs à la whitelist.

6. Gmod Advanced Character Creator System: Créez plusieurs personnages dans divers jobs, avec une compatibilité assurée entre les bases de données séparées des différents personnages créés.

Conseil pour éviter les leaks de WJob - Gmod Whitelisting Job System 2 installé sur votre serveur Garry's mod: Comment éviter la fuite de vos scripts Gmod
Comment Installer un addon Gmod: Comment installer un addon sur Gmod?
Publier un Addon Gmod sur le workshop: Documentation comment créer un pack de contenu à publier sur l'atelier?