Installer ULX et ULib sur Garry's Mod
Installez ULX et ULib sur votre serveur Garry's Mod Linux : premier superadmin, groupes, droits, sanctions, sauvegarde des administrateurs, mises à jour et dépannage.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Ce guide vous explique comment installer ULX, le mod d'administration de Garry's Mod, avec sa bibliothèque ULib, puis comment nommer vos administrateurs, créer des groupes et leur attribuer des droits précis.
HostMyServers ne propose pas d'hébergement de jeux géré : vous administrez vous-même ce serveur sur votre VPS ou votre serveur dédié.
Prérequis
- Un serveur installé avec le guide Créer un serveur Garry's Mod. Ce guide repart de son utilisateur
gmod, du dossier/home/gmod/gmod-serveret du servicegmod.service - Le script
/home/gmod/backup.sh, décrit dans la section Sauvegarde automatique de ce même guide - Un accès SSH avec
sudo - Le RCON configuré et le port TCP 27015 autorisé depuis votre adresse IP, ou un compte déjà déclaré
superadmindanssettings/users.txt - Votre SteamID au format
STEAM_0:X:XXXXXXXX, visible avec la commandestatusune fois connecté
Organisation des fichiers
Tous les chemins ci-dessous partent de /home/gmod/gmod-server/garrysmod.
| Élément | Emplacement | Rôle |
|---|---|---|
| ULib | addons/ulib |
Bibliothèque requise par ULX |
| ULX | addons/ulx |
Commandes et menu d'administration |
| Utilisateurs et bannissements | sv.db |
Tables SQLite ulib_users et ulib_bans |
| Groupes | data/ulib/groups.txt |
Groupes et droits associés |
| Copies des utilisateurs | data/ulib_backups |
Copies créées par ULib au démarrage |
| Configuration d'ULX | data/ulx/config.txt |
Message d'accueil, journaux, votes |
| Journaux d'ULX | data/ulx_logs |
Historique des actions |
Les fichiers de data/ulx et data/ulib sont créés au premier démarrage avec les addons.
Étape 1 : sauvegarder le serveur
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -u gmod ls -lh /home/gmod/backupsL'archive la plus récente doit porter la date du jour. Elle contient notamment sv.db, data, settings et addons.
Étape 2 : installer ULib et ULX
Ouvrez une session avec l'utilisateur gmod, puis récupérez les dépôts officiels dans le dossier des addons :
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git clone https://github.com/TeamUlysses/ulib.git ulib
git clone https://github.com/TeamUlysses/ulx.git ulxContrôlez la structure obtenue :
ls ulib/lua/autorun/ulib_init.lua ulib/lua/ulib/init.lua ulx/lua/ulib/modules/ulx_init.lua ulx/lua/ulx/init.lua
exitLes quatre fichiers doivent s'afficher sans erreur. Les dossiers ulib et ulx doivent rester en minuscules.
Étape 3 : démarrer le serveur et vérifier le chargement
Un redémarrage complet est obligatoire : un simple changement de carte ne suffit pas.
sudo systemctl start gmod.servicePatientez le temps du chargement, puis cherchez les messages des deux addons :
sudo journalctl -u gmod.service -n 500 --no-pager | grep -E 'Ulysses Library|ULX Admin Mod'Les lignes Ulysses Library et ULX Admin Mod confirment leur chargement. Vérifiez ensuite que les fichiers de données ont été créés :
sudo -u gmod ls /home/gmod/gmod-server/garrysmod/data/ulib /home/gmod/gmod-server/garrysmod/data/ulxÉtape 4 : nommer le premier superadmin
Le groupe superadmin a accès à toutes les commandes. Choisissez la méthode adaptée à votre situation.
Par le RCON
Depuis la console du jeu, en remplaçant les valeurs d'exemple :
rcon_address IP_DU_SERVEUR:27015
rcon_password VotreMotDePasse
rcon ulx adduserid "STEAM_0:X:XXXXXXXX" superadminSi vous êtes déjà superadmin dans users.txt
Si votre compte figure dans settings/users.txt, connectez-vous et enregistrez-le dans ULX depuis la console du jeu :
ulx adduser "VotrePseudo" superadminVérifier le résultat
Reconnectez-vous au serveur, puis saisissez dans la console du jeu :
ulx whoVotre compte doit apparaître dans le groupe superadmin. Écrivez ensuite !menu dans le chat : le menu d'administration XGUI s'ouvre. La commande ulx menu fait la même chose depuis la console.
Étape 5 : créer un groupe
ULX fournit ces groupes :
| Groupe | Hérite de | Peut cibler |
|---|---|---|
user |
Aucun | Tous |
operator |
user |
Les joueurs sous le niveau admin |
admin |
operator |
Les joueurs sous le niveau superadmin |
superadmin |
admin |
Tous |
Pour créer un groupe de modérateurs qui peut seulement expulser des joueurs, saisissez ces commandes dans la console du jeu avec votre compte superadmin :
ulx addgroup moderateur operator
ulx groupallow moderateur "ulx kick"
ulx setgroupcantarget moderateur "!%admin"
ulx adduser "PseudoDuModerateur" moderateurLa cible !%admin empêche le groupe de viser les administrateurs et les groupes supérieurs.
Pour vérifier, connectez-vous avec le compte du modérateur et lancez ulx help dans la console : la liste n'affiche que les commandes auxquelles ce compte a accès. Un essai de commande non autorisée renvoie You don't have access to this command.
Gérer les droits et les membres
| Commande | Effet |
|---|---|
ulx adduser "Pseudo" groupe |
Ajoute un joueur connecté à un groupe |
ulx adduserid "STEAM_0:X:XXXXXXXX" groupe |
Ajoute un joueur par son SteamID, même absent |
ulx removeuser "Pseudo" |
Retire tous les droits d'un joueur connecté |
ulx removeuserid "STEAM_0:X:XXXXXXXX" |
Retire tous les droits par SteamID |
ulx groupallow groupe "ulx commande" |
Donne un droit à un groupe |
ulx groupdeny groupe "ulx commande" |
Retire un droit à un groupe |
ulx userallow "Pseudo" "ulx commande" |
Donne un droit à un joueur |
ulx userdeny "Pseudo" "ulx commande" |
Retire un droit à un joueur |
ulx removegroup groupe |
Supprime un groupe |
ulx usermanagementhelp |
Affiche l'aide détaillée sur les droits |
Utiliser ULX au quotidien
Les commandes s'utilisent dans la console (ulx kick) ou dans le chat (!kick).
| Console | Chat | Effet | Accès par défaut |
|---|---|---|---|
ulx kick "Pseudo" raison |
!kick |
Expulse un joueur | admin |
ulx ban "Pseudo" 60 raison |
!ban |
Bannit pendant 60 minutes, 0 pour un bannissement définitif |
admin |
ulx banid "STEAM_0:X:XXXXXXXX" 60 raison |
!banid |
Bannit par SteamID | superadmin |
ulx unban "STEAM_0:X:XXXXXXXX" |
!unban |
Lève un bannissement | admin |
ulx map nom_de_carte |
!map |
Change de carte | admin |
ulx noclip |
!noclip |
Active ou coupe le vol libre | admin |
ulx spectate "Pseudo" |
!spectate |
Observe un joueur | admin |
Vous pouvez viser plusieurs joueurs avec ces mots-clés : ^ pour vous-même, @ pour le joueur que vous regardez, * pour tous, #groupe pour les membres d'un groupe et %groupe pour ce groupe et ceux qui en héritent. Un ! placé devant inverse la sélection.
Configurer ULX
Ouvrez le fichier de configuration :
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/data/ulx/config.txtVoici quelques réglages utiles. Les lignes commençant par ; sont des commentaires.
ulx showMotd 0
ulx welcomemessage "Bienvenue sur %host%, carte %curmap%."
ulx logFile 1
ulx logDir "ulx_logs"| Réglage | Effet |
|---|---|
ulx showMotd |
Message à la connexion : 0 désactivé, 1 fichier, 2 générateur intégré, 3 adresse web |
ulx welcomemessage |
Message d'accueil, vide pour le désactiver |
ulx logFile |
Enregistre les journaux dans un fichier |
ulx logDir |
Dossier des journaux, sous garrysmod/data |
Redémarrez le serveur pour appliquer les changements :
sudo systemctl restart gmod.servicePour un réglage propre à un gamemode, créez data/ulx/gamemodes/darkrp/config.txt, en adaptant le nom du gamemode. Si vous utilisez DarkRP, consultez aussi Installer et configurer DarkRP.
Sauvegarder les administrateurs
ULib copie la liste des utilisateurs dans data/ulib_backups à chaque démarrage. Vous pouvez aussi lancer ces commandes par le RCON :
rcon ucl_backup_users force
rcon ucl_restore_users latestLa première crée une copie immédiate. La seconde remplace la liste actuelle par la copie la plus récente : ne l'utilisez qu'en cas de problème. Ces copies complètent backup.sh, qui reste votre vraie sauvegarde.
Mettre à jour ULib et ULX
Mettez toujours à jour les deux addons ensemble, en notant d'abord leur version :
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git -C ulib rev-parse HEAD > ~/ulib-avant-maj.txt
git -C ulx rev-parse HEAD > ~/ulx-avant-maj.txt
git -C ulib pull --ff-only
git -C ulx pull --ff-only
exit
sudo systemctl start gmod.serviceRefaites ensuite les vérifications de l'étape 3 et lancez ulx who en jeu.
Revenir en arrière
Revenir à la version précédente
Une mise à jour peut modifier le format des données. Restaurez donc aussi l'archive créée juste avant, en remplaçant son nom :
sudo systemctl stop gmod.service
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git -C ulib reset --hard "$(cat ~/ulib-avant-maj.txt)"
git -C ulx reset --hard "$(cat ~/ulx-avant-maj.txt)"
tar -xzf ~/backups/gmod_AAAA-MM-JJ_HH-MM-SS.tar.gz -C ~/gmod-server/garrysmod sv.db data
exit
sudo systemctl start gmod.serviceLes changements faits depuis cette archive, comme les nouveaux bannissements, sont perdus.
Désactiver ULX
sudo systemctl stop gmod.service
sudo -iu gmod
mkdir -p ~/addons-desactives
mv ~/gmod-server/garrysmod/addons/ulx ~/gmod-server/garrysmod/addons/ulib ~/addons-desactives/
exit
sudo systemctl start gmod.serviceLe serveur revient alors à la liste settings/users.txt de Garry's Mod.
En cas de problème
La commande ulx est inconnue
- Vérifiez que le serveur a bien été redémarré après l'installation
- Contrôlez les fichiers de l'étape 2 : un dossier mal nommé ou imbriqué, comme
addons/ulx/ulx, empêche le chargement - Vérifiez que ULib est présent : ULX ne fonctionne pas sans lui
- Recherchez les erreurs :
sudo journalctl -u gmod.service -n 500 --no-pager | grep -iE 'ulib|ulx|\[error\]'
Bad RCON password
Le mot de passe saisi ne correspond pas à rcon_password dans server.cfg. Si la connexion n'aboutit pas du tout, vérifiez que votre adresse IP est autorisée sur le port TCP 27015.
Invalid steamid.
Le SteamID est mal formé. Copiez-le depuis la commande status et gardez les guillemets.
invalid group "..." specified
Le groupe n'existe pas. Vérifiez son orthographe, ou créez-le avec ulx addgroup.
You don't have access to this command
Votre compte n'a pas ce droit. Contrôlez votre groupe avec ulx who, et reconnectez-vous si vous venez d'en changer.
No player with id "..." exists in the ULib user list
Ce SteamID n'a aucun droit enregistré. Il n'y a donc rien à retirer.
Un administrateur retrouve son groupe après l'avoir perdu
Il figure encore dans settings/users.txt, ou dans GM.Config.DefaultPlayerGroups si vous utilisez DarkRP. Retirez-le de ces listes, puis redémarrez le serveur.
The users database failed to load.
ULib n'arrive pas à lire sa table dans sv.db. Le message suivant, Error while querying database was:, donne la cause. Vérifiez l'espace disque avec df -h, puis restaurez sv.db depuis votre dernière archive, serveur arrêté.
Le fichier users.txt d'ULib ne change plus
C'est normal : les versions récentes d'ULib stockent les utilisateurs dans sv.db. Certaines documentations citent encore l'ancien fichier. Passez par les commandes ulx adduser et ulx adduserid.
FAQ
Peut-on installer ULX depuis le Workshop ?
Oui, avec les identifiants 557962238 pour ULib et 557962280 pour ULX, à ajouter à votre collection. Retirez alors les dossiers addons/ulib et addons/ulx pour éviter d'avoir deux copies.
ULX remplace-t-il FAdmin sur DarkRP ?
Les deux outils sont indépendants. FAdmin est fourni avec DarkRP. Si vous préférez n'utiliser qu'ULX, vous pouvez le désactiver avec ["fadmin"] = true, dans disabled_defaults.lua.
Où trouver la liste complète des commandes ?
Lancez ulx help dans la console, ou consultez le site du projet Ulysses.