Nor Admin Mod for GMod - Administration System (FR) - Script
Nor Admin Mod est un addon d'administration pour Gmod 100% codé à partir de zéro, il se veut petit, et ultra optimisé, il ne comporte aucune boucle et vous permet de faire le travail d'un admin, de créer votre staff et de distribuer le pouvoir en fonction des grades, de gérer les nouveaux grades et de personnaliser les accès à vos différents scripts comme vous le souhaitez sans alourdir le système. Grâce à l'API créez les accès que vous avez créés, compatibles avec tous vos scripts. Générez également un statut de donateur à vos membres (VIP) pour leur distribuer des avantages. Lisez la description pour plus de détails.
❮
❯
Description de Nor Admin Mod for GMod - Administration System
🚀 Presentation
"Nor Admin Mod" est un addon d'administration méticuleusement développé pour Garry's Mod, construit à partir de zéro pour s'adapter à tous les gamemodes. Son objectif principal est de fournir une solution compacte et optimisée, dépourvue de toute boucle, permettant des tâches d'administration efficaces. Avec cet addon, vous pouvez gérer votre personnel sans effort, déléguer l'autorité basée sur les rangs hiérarchiques, assurant la simplicité sans compromettre la performance. En outre, il vous permet de personnaliser les privilèges d'accès pour divers scripts, en s'intégrant de manière transparente à un système orienté sur le long terme.
En utilisant l'API, vous pouvez facilement créer des contrôles d'accès personnalisés compatibles avec tous les scripts qui vous sont attribués, simplement en basculant un interrupteur ON/OFF intuitif. En outre, vous pouvez conférer le statut de donateur (VIP) à vos membres, en leur accordant un rang VIP par le biais d'une interface conviviale ou de commandes de serveur, ce qui est entièrement compatible avec les systèmes de donation les plus courants.
Ce script remplace avantageusement les systèmes d'administration obsolètes qui ne bénéficient pas d'un support adéquat, garantissant ainsi une évolution continue grâce à vos précieuses contributions.
Une fois installé, l'addon fonctionne parfaitement, vous permettant d'accéder au panneau d'administration en appuyant sur la touche F2 (par défaut). Vous vous adapterez rapidement à ses nouvelles fonctionnalités et apprécierez sa navigation fluide et son design convivial.
Notamment, les utilisateurs bannis sont empêchés de revenir en utilisant la même adresse IP ou en exploitant le partage familial.
De plus, en utilisant n'importe quel système de donation qui supporte l'envoi de commandes au serveur, vous pouvez automatiser sans effort la distribution des rôles VIP aux donateurs.
En résumé, cet addon constitue une alternative viable aux solutions d'administration établies comme ULX, SAM admin et ServerGuard.
🧬 Optimisation de la taille des fichiers Lua pour Nor Gmod Admin Mod
L'objectif de l'investissement dans la réduction de la taille des fichiers Lua sur votre serveur Garry's Mod était d'optimiser le temps de chargement de vos utilisateurs. Il est injuste que vos joueurs non administrateurs subissent des temps de chargement prolongés en raison de l'inclusion d'outils qu'ils n'utiliseront jamais. Alors que certains systèmes d'administration ajoutent 2 Mo à la taille totale du fichier à télécharger, Nor Admin Mod se distingue en ne nécessitant que 0,029 Mo côté client. Cette réduction est perceptible dans le temps de chargement d'un serveur Garry's Mod car le processus de téléchargement introduit un décalage (latence). Plus les fichiers Lua à télécharger sont volumineux, plus le temps de chargement de vos utilisateurs sera long, augmentant ainsi la probabilité de perdre des joueurs lors de cette phase critique, comme sur le web.
📦 Caractéristiques du système Nor Admin Mod
- Un tableau de gestion d'utilisateur : C'est le premier menu qui s'affiche lorsque vous pressez F2, Cliquez sur la ligne que vous voulez pour faire une action sur un utilisateur, retrouvez la liste des actions administrative plus bas.
- Un Système de gestion de votre team (Votre staff). Il contient un système de recherche pour retrouver une ligne avec un simple steamid64 ou un nom.
- Un Système de gestion des utilisateurs banni. Il contient un système de recherche pour retrouver une ligne avec un simple steamid64 ou un nom
- Un Gestion de la liste de vos membres VIP. Il contient un système de recherche pour retrouver une ligne avec un simple steamid ou un pseudo
- Un Système de création de rangs : Ajoutez des rangs avec l'index que vous souhaitez, le nom et son level par rapport aux autres rangs.
- Système de gestion de rangs : Modifiez un rang déjà créé, c'est à dire, l'id, le nom et le level.
- Système de génération d'accès pour chaque rang
- Système de gestion des accès pour chaque rang
- Système de reboot différé ou instantané
- Système de changement de map différé ou instantanément
- Système des boutons outils qui permet de rapidement lancer une annonce, de clear les decals pour tous, de stopsound pour tous, de cleanup les entités de tout le monde.
- L'admin Systeme contient un ESP Admin qui vous permet de voir les positions des joueurs et autres entités que vous avez choisi depuis l'interface d'administration, parmi.
- Un Système de surveillance dans la liste des utilisateurs qui permet d'indiquer si ils utilisent le godmod, s'ils sont freeze, ect.
- Un Système d'avertissement, lorsqu'un utilisateur est averti, un triangle jaune apparait à coté de son pseudo dans la liste.
- Traduit en plusieurs langue: English, French, German, Russian, Spanish, et plus si suggéré
👑 Tout les types d'action Admin que vous pouvez faire sur un joueur
- Promouvoir le rang d'un utilisateur, et en choisir la durée, par exemple vous pourrez mettre un utilisateur modérateur une semaine, ou 3 jour, ou permanent.
- Kick / bannir, et choisir la durée.
- Donner le rang VIP à un utilisateur lorsqu'il fait une donation ou offrir le rang comme récompense. Même chose vous pouvez choisir la durée du VIP
- Invisibilité en jeu, cela rend l'utilisateur invisible
- Invisibilité dans le menu Tab, cela rend l'utilisateur invisible dans les tab menu compatible.
- Le Godmod, pour être invincible, l'icone s'affiche dans la colonne mods de la liste
- Freeze, pour stopper tout les déplacements d'un utilisateur
- Spectate pour vous ce que fait un autre utilisateur, utile pour detecter les ESP et observer les comportements suspect.
- Teleportation contient la fonction : Goto pour aller vers l'utilisateur, Bring pour faire apparaitre l'utilisateur devant vous, Look pour faire apparaitre là où vous regardez, Return pour faire retourner l'utilisateur à sa dernière position avant que vous l'avez téléporter pour qu'il puisse continuer sa partie
- Warn pour avertir un utilisateur, un triangle jaune apparait pour les utilisateurs avertit.
- Touch Life permet de configurer les HP max d'un joueur, de soigner, de donner/retirer des points d'armure, d'attribuer des damages ou de Slay.
- Cleanup entities, permet de supprimer les entités spawn par l'utilisateur visé
- SetModel permet de changer le playermodel
- DarkRP : permet de changer le job d'un utilisateur si le DarkRP est installé
- SetMoney permet de donner/Retirer de l'argent au joueur
- Steam, permet de copier, le steamid, le steamid64 et d'ouvrir la page de profile steam de l'utilisateur
🛡️ Securité
- Sécurise Player:SetUserGroup(), les addons du Workshop de Garry's Mod ne peuvent plus bypasser les fonctions de base de sécurité. Cela permet d'éviter qu'un addon du workshop soit mis à jour à votre insu et que tout le monde se retrouve administrateur sur votre serveur sans demander votre avis. La sécurité ça sert à ça.
- Vous pouvez voir qui est en mode spectateur et aussi qui a le godmod d'activé, utile pour les oublies mais aussi pour ceux qui arrivent à se donner le godmod.
- Le système de bannissement, banni par SteamID64 et aussi IP, si l'utilisateur revient avec un autre compte en partage familial cela est aussi détecté.
📌 ADMIN ESP
L'admin ESP vous permet de voir à travers toute la carte la position des joueurs, vehicules, npcs, props, items, Armes, Portes, Echelles, une options autre pour les entités non listé. Chaqu'une de ses entités, peuvent être filtré depuis l'interface. Exemple, si pour props vous mettez sur OFF, l'ESP n'indiquera plus la position des Props
📌 Commands
Commande pour ouvrir le panneau de gestion : nor_admin_mod
Commande Chat : !admin ou /admin
💾 Sauvegarde
Les actions sont sauvegardé au moment de la modification, Mysql est utilisé par défaut. Si vous n'avez pas de serveur Mysql sous la main vous pouvez utiliser celle déjà inclus dans garry's mod, automatiquement fonctionnel.
📌 Configuration
Il n'y a pas besoin de connaissance pour l'utiliser, une fois installé et ça fonctionne. L'utilisateur qui a téléchargé le script sera automatiquement dans les superadmin.
Tout est configurable depuis l'interface accessible avec la commande chat : "!admin or /admin"
Le fichier de configuration se trouve à cette emplacement : norda_admin_mod/ lua/ autorun/ norda_admin_mod_config.lua
✅ Compatibility
Compatible avec Prometheus : La commande serveur pour donner le rang VIP à un utilisateur sert à ça.
Compatible avec tous les gamemodes DarkRP et leurs variants, StarwarsRP, HogwartsRP, CityRP, gtaRP, AnimRP, MangaRP, ScoolRP, CloneRP, CloneRP, HaloRP, HarryPotterRP, PoudlardRP, MedievalRP, StalkerRP.
Chemin: garrysmod/addons/nor_admin_mod
- La fonction AddWorkshop est automatiquement ajouté dans le fichier serveur du script il est désactivable depuis le fichier configuration : resource.AddWorkshop( 2559536263 )
- Pour ajouter les ressources du workshop de gmod à votre collection : Nor Admin Mod for GMod - Administration System [Ressouces seulement] | Gmod Workshop
Autrement vous pouvez toujours utiliser la commande Chat : !admin
1- Depuis le menu d'administration, Gestion des joueurs / Utilisateur connecté, cliquez sur le joueur, ensuite promouvoir et choisissez le rang que vous voulez donner et la durée. Puisque vous pouvez choisir une durée ou si c'est permanent.
2- Depuis le scoreboard cliquez sur le joueur ensuite même chose que la solution #1
3- Dans l'onglet "Liste des membres du Staff" Inserez le SteamID64 et le nom et cliquez sur "Ajouter". Vous n'aurez plus qu'à choisir la durée.
4- Depuis la commande serveur
1- Depuis le menu d'administration, Gestion des joueurs / Utilisateur connecté, cliquez sur le joueur, ensuite "Expulsion" et choisissez "Ban" choisissez ensuite la durée. Il est possible de bannir définitivement également.
2- Depuis le scoreboard cliquez sur le joueur ensuite même chose que la solution #1
3- Dans l'onglet "Liste des utilisateurs banni" Inserez le SteamID64 et le nom et l'ip(optionnel) et cliquez sur "Ajouter". Vous n'aurez plus qu'à choisir la durée.
4- Depuis la commande serveur
1- Depuis le menu d'administration, Gestion des joueurs / Utilisateur connecté, cliquez sur le joueur, ensuite "Donner manuellement le rang VIP et selectionnez durée (Permanent, 1 jours, 2j, 3j, 1mois, ect...).
2- Depuis le scoreboard cliquez sur le joueur ensuite même chose que la solution #1
3- Dans l'onglet "Liste des membres VIP" Insérez le SteamID64 et le nom et cliquez sur "Ajouter". Vous n'aurez plus qu'à choisir la durée.
4- Depuis la commande serveur
Vous pourrez y voir la liste des rangs déjà crée. Par défaut : superadmin, admin, moderator, vip, user.
Pour créer un nouveau rang créez un id unique c'est à dire un nom sans espacement, sans majuscule.
par exemple pour un rang qui s'appellerait "Super Admin" l'unique_id sera "superamdin".
Une fois l'unique_id et le nom du rang écrit cliquez sur "Créer un nouveau rang"
Voilà votre nouveau rang aura était créé. Ce qui fera un rang en plus dans la liste.
Vous verrez la liste des rangs qui existent. Cliquez sur le rang que vous souhaitez modifier.
S'affichera alors la possibilité de modifier l'id du rang, le nom du rang et le level du rang.
Il vous sera possible de générer des accès spéciaux par rangs pour d'autre scripts ne faisant pas partie de ma création.
Vous verrez alors s'afficher la liste des rangs et lorsque vous sélectionnez un rang vous pourrez voir tout les pouvoirs dans la liste à droite, Certains seront sur "ON" d'autres sur "OFF".
Pour Activer et désactiver un accès cliquez sur le bouton ON/OFF
Pour supprimer un accès cliquez sur la croix à droite de chaque ligne. Si un accès est supprimé, c'est à dire que la ligne n'existe plus, les super admin auront toujours un droit sur l'action.
Les standard de Gmod ré-écrit compatible que vous connaissez déjà qui vous sera familier avec Nor Admin Mod :
player:IsSuperAdmin() -- Un utilisateur qui a le rang superadmin retournera true, depuis le système d'accès les rangs qui auront un accès sur "ON" pour "access_superadmin" retournera aussi un true
player:IsAdmin() -- Un utilisateur qui a le rang admin retournera true, depuis le système d'accès les rangs qui auront un accès sur "ON" pour "access_admin" retournera aussi un true
player:SetUserGroup(str) -- Permettra de changer le rang d'un utilisateur
player:GetUserGroup() -- Retourne le rang de l'utilisateur
player:IsUserGroup(name)
-- Retourna true si le rang de l'utilisateur est égale à celui de name, Sinon false.
Les Ajouts apporté par Nor Admin Mod :
player:CheckUserAccess(unique_id) -- Par exemple avec l'unique_id "access_superadmin" obtenu depuis l'interface permet de rendre d'autres rangs superadmin.
player:IsAbove(player2) --Permet de savoir quel staff est plus élevé qu'un autre. Par exemple un Modérateur ne pourra pas kicker un Admin.
Le premier bouton permet de rebooter votre serveur, cliquez dessus, choisissez si l'effet est immédiat autrement choisissez un délai. Tout le monde sera avertie.
Cliquez sur la map que vous avez choisi, choisissez si l'effet est immédiat autrement choisissez un délai. Tout le monde sera avertie.
Pour se faire rendez vous sur Réglages du serveur / Annonce cliquez dessus et écrivez votre message, il s'affichera dans le chat, dans la console et au centre de l'HUD de chaque utilisateur.
Pour se faire rendez vous sur Réglages du serveur / Clear Decals et cliquez dessus. C'est fait.
Pour se faire rendez vous sur Réglages du serveur / Stopsound et cliquez dessus. C'est fait.
Pour se faire rendez vous sur Réglages du serveur / Cleanup Entities et cliquez dessus. C'est fait.
Pour l'activer Rendez vous dans Admin ESP : Et positionnez le curseur sur ON à la première ligne "Activation de l'ESP"
Lorsque vous avez fini vous pouvez retourner à votre place avec (Return)
Ou le faire retourner à sa position avant sa téléportation avec (Return)
Goto = Se téléporter vers l'utilisateur.
Bring = Téléporter l'utilisateur vers vous.
Teleport = Téléporter un utilisateur là où vous regardez.
Return = Retourner à la position d'origine.
Autrement suivez cette étape :
Dans Gestion des joueurs / VIP list (Icone Jaune) Cliquez sur l'utilisateur que vous souhaitez retirer, si vous ne le trouvez pas parce que vous avez du monde dans la liste, utilisez alors la fonction "Recherche" elle fonctionne par nom et aussi par SteamID64.
Pour se faire rendez vous sur Réglages du serveur / Tool Buttons / Cleanup Entities et cliquez dessus. C'est fait.
Pour printer la liste des accès dans la console du serveur
Utilisez la commande : "nor_admin_debug_sv ranks"
Pour printer la liste des rangs dans la console du serveur
Pour tester le role d'un joueur: "nor_admin_debug_sv userrank"
Pour printer dans la console du serveur le role de l'utilisateur et le retour des fonctions de vérification de role.
player:GetUserGroup()
player:IsSuperAdmin()
player:IsAdmin()
player:IsModerator()
Pour tester les accès d'un utilisateur, Utilisez la commande : "nor_admin_debug_sv test_access {ici l'id de l'access}"
Pour printer l'accessibilité au pouvoir accordé, cela retournera toujours un true pour les superadmins.
Pour faire le test coté client il faudra alors remplacer la commande "nor_admin_debug_sv" par "nor_admin_debug_cl"
SteamiD64 est le steamid64 de l’utilisateur
Name = Son nom
Delay = Mettez 0 pour que cela soit permanent. Sinon mettez en seconde si vous souhaitez mettre un délai. Par exemple 86 400 secondes pour un jour.
Par exemple pour ajouter l'utilisateur Norda de façon permanent ce sera: add_vip 76561198033784269 "Norda"
Pour ajouter l'utilisateur Norda de 1 jour ce sera: add_vip 76561198033784269 "Norda" 86400
N'oubliez pas les guillemet pour les noms.
SteamiD64 = Le steamid64 de l’utilisateur
Name = Son nom
Raison = Le motif de bannissement
Ip = Adresse ip (optionnel)
Delay = Laissez vide pour que cela soit permanent. Sinon mettez en seconde si vous souhaitez mettre un délai. Par exemple 86400 secondes pour un jour, il s'agit du nombre de seconde qu'il y a dans une journée.
Par exemple pour Bannir l'utilisateur Nordahl de façon permanent ce sera: add_ban 76561198033784269 "Norda" "Its a Test" 0 "192.162.0.1"
Pour ajouter l'utilisateur Norda de 1 jour ce sera: add_ban 76561198033784269 "Norda" "Its a Test" 86400 "192.162.0.1"
N'oubliez pas les guillemet pour les noms, la raison, l'adresse ip.
SteamiD64 est le steamid64 de l’utilisateur
Name = Son nom
Delay = Mettez rien pour que cela soit permanent. Sinon mettez en seconde le délai d'expiration. Par exemple 86400 secondes pour un jour.
Par exemple pour ajouter l'utilisateur Norda de façon permanent ce sera: add_staff 76561198033784269 "Norda" "superadmin"
Pour ajouter l'utilisateur Norda de 1 jour ce sera: add_staff 76561198033784269 "Norda" "superadmin" 86400
N'oubliez pas les guillemet pour les noms et le rang.