Installer ULX et ULib sur un serveur Garry's Mod

Introduction

ULX (Ulysses ULX) avec sa dépendance ULib est le standard de fait pour l'administration GMod depuis plus de 15 ans. C'est ce que la majorité des serveurs DarkRP, TTT, Sandbox utilisent. Pas le plus moderne, mais le plus universel. Ce guide te le met en place en 10 minutes.

Prérequis

• Un serveur Garry's Mod chez VeryCloud
• Accès Files dans le panel Wisp
• Ton SteamID64 (le tuto sbox permissions explique comment le récupérer)

Étape 1 : Télécharger ULib et ULX

ULib est la base, ULX la couche d'admin. Les deux sont obligatoires.

• ULib : https://github.com/TeamUlysses/ulib/archive/master.zip
• ULX : https://github.com/TeamUlysses/ulx/archive/master.zip

Extrait les deux ZIP localement. Tu obtiens deux dossiers ulib-master/ et ulx-master/.

Étape 2 : Uploader sur le serveur

Dans Wisp → Files :

1. Va dans /garrysmod/addons/
2. Crée deux dossiers : ulib et ulx
3. Upload le contenu de ulib-master/ dans ulib/
4. Upload le contenu de ulx-master/ dans ulx/

Structure attendue après upload :

/garrysmod/addons/ulib/
  ├── lua/
  ├── data/
  └── ulib_addon_info.txt

/garrysmod/addons/ulx/
  ├── lua/
  ├── data/
  └── ulx_addon_info.txt

Étape 3 : Restart le serveur

Depuis la console Wisp, Restart. Dans les logs au boot tu dois voir :

[ULib] Loaded
[ULX] Loaded

Étape 4 : Te promouvoir superadmin

Connecte-toi en jeu (avec rcon ou en console depuis Wisp) :

ulx adduser <ton_pseudo> superadmin

Ou directement dans la console serveur (panel Wisp) :

ulx adduser MathysAdmin superadmin

💡 Si tu n'es pas connecté au serveur, utilise ulx asay avec ton SteamID : ulx adduserid STEAM_0:1:XXXXX superadmin

Étape 5 : Tester les commandes

Une fois superadmin, en jeu, tape !menu ou !xgui. La fenêtre d'admin XGUI s'ouvre — c'est l'interface graphique d'ULX.

Tu peux y :

• Bannir des joueurs
• Kick, slay, gag
• Donner des armes
• Téléporter
• Gérer les groupes et permissions

Étape 6 : Créer des groupes custom

Dans la console (ou XGUI) :

ulx groupadd <nom_groupe> <pouvoirs_heritels>
# Exemple
ulx groupadd vip user
ulx groupadd moderator user

Le user final indique d'hériter des permissions du groupe user (groupe de base).

Étape 7 : Permissions par commande

ulx groupallow moderator ulx kick
ulx groupallow moderator ulx slay
ulx groupallow moderator ulx mute
ulx groupallow vip ulx noclip

Liste complète des commandes ULX : ulx help ou !help en jeu.

Étape 8 : Ajouter des joueurs à un groupe

ulx adduser <nom_joueur> <groupe>

Le joueur doit être connecté au serveur au moment de la commande. Pour un offline :

ulx adduserid STEAM_0:1:XXXXX <groupe>

Étape 9 : Sauvegarder la config

Toutes les modifs sont auto-sauvegardées dans :

/garrysmod/data/ulib/users.txt
/garrysmod/data/ulib/groups.txt

Pour migrer vers un autre serveur, copie ces deux fichiers.

Étape 10 : Intégrer avec un gamemode (DarkRP, TTT)

ULX se branche automatiquement sur la plupart des gamemodes. Pour DarkRP, les rôles ULX (admin, superadmin) sont reconnus pour les permissions spécifiques DarkRP.

Pour customiser, voir la doc du gamemode : généralement un darkrp_modules/jobs/jobs.lua ou équivalent où tu peux mapper customCheck sur ULX.

Dépannage

"You don't have access to this command"

• Tu n'es pas dans le bon groupe : ulx whoami te dit ton groupe actuel
• Le groupe n'a pas la permission : ulx groupallow <groupe> <commande>

ULX ne charge pas au boot

• Vérifie que les dossiers sont bien /addons/ulib/ et /addons/ulx/ (pas /addons/ulib-master/)
• Permissions Linux : chmod -R 644 les fichiers Lua si tu as un accès console

Conflit avec un autre admin mod

• Désinstalle SAM, Maul, Evolve si tu en avais avant
• Ne mélange jamais 2 admin mods, ça casse tout

Commandes utiles

ulx help                          # Liste des commandes
ulx adduser <nom> <groupe>        # Ajouter au groupe
ulx removeuser <nom>              # Retirer du groupe
ulx groupadd <nom> <herite>       # Creer un groupe
ulx groupallow <groupe> <cmd>     # Permission
ulx kick <nom> <raison>           # Kick
ulx ban <nom> <minutes> <raison>  # Ban
ulx slay <nom>                    # Tuer
ulx noclip <nom>                  # Noclip
!menu                             # XGUI (interface graphique)

Conclusion

ULX + ULib = standard 15 ans, ça marche partout, c'est documenté. Pas le plus sexy mais le plus fiable. Si tu veux du plus moderne, regarde SAM (Sourcebans-like) ou Maul, mais pour 90% des serveurs ULX suffit largement.

Pour aller plus loin : ULX RP integration (DarkRP roles), bans persistants avec MySQL via ULib MySQL extension, dashboard Discord pour les bans.

Ressources

• ULX — Site officiel
• ULib GitHub
• ULX GitHub
• Forum communautaire Ulysses