FR

Serveurs de jeux

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.

8 min de lecture, mis à jour le 18 novembre 2026

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-server et du service gmod.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é superadmin dans settings/users.txt
  • Votre SteamID au format STEAM_0:X:XXXXXXXX, visible avec la commande status une 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

Terminal
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -u gmod ls -lh /home/gmod/backups

L'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 :

Terminal
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 ulx

Contrôlez la structure obtenue :

Terminal
ls ulib/lua/autorun/ulib_init.lua ulib/lua/ulib/init.lua ulx/lua/ulib/modules/ulx_init.lua ulx/lua/ulx/init.lua
exit

Les 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.

Terminal
sudo systemctl start gmod.service

Patientez le temps du chargement, puis cherchez les messages des deux addons :

Terminal
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 :

Terminal
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 :

Texte
rcon_address IP_DU_SERVEUR:27015
rcon_password VotreMotDePasse
rcon ulx adduserid "STEAM_0:X:XXXXXXXX" superadmin

Si 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 :

Texte
ulx adduser "VotrePseudo" superadmin

Vérifier le résultat

Reconnectez-vous au serveur, puis saisissez dans la console du jeu :

Texte
ulx who

Votre 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 :

Texte
ulx addgroup moderateur operator
ulx groupallow moderateur "ulx kick"
ulx setgroupcantarget moderateur "!%admin"
ulx adduser "PseudoDuModerateur" moderateur

La 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 :

Terminal
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/data/ulx/config.txt

Voici quelques réglages utiles. Les lignes commençant par ; sont des commentaires.

Texte
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 :

Terminal
sudo systemctl restart gmod.service

Pour 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 :

Texte
rcon ucl_backup_users force
rcon ucl_restore_users latest

La 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 :

Terminal
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.service

Refaites 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 :

Terminal
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.service

Les changements faits depuis cette archive, comme les nouveaux bannissements, sont perdus.

Désactiver ULX

Terminal
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.service

Le 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.