Ce guide explique comment installer et configurer le mod d'administration ULX sur votre serveur Garry's Mod hébergé chez Legion Hosting, incluant l'installation, l'attribution des permissions d'administrateur, les commandes courantes et la gestion des groupes de permissions.
Table des matières
- Installation de ULX et ULib
- S'attribuer le rang Superadmin
- Commandes ULX courantes
- Groupes de permissions
- Commandes de chat
- Fichiers de configuration
1. Installation de ULX et ULib
ULX est le mod d'administration le plus utilisé pour Garry's Mod. Il nécessite l'installation de deux addons ensemble :
| Addon | Workshop ID | Notes |
|---|---|---|
| ULib | 557962280 | Bibliothèque requise pour ULX. Doit être installée en premier. |
| ULX | 557962238 | Le mod d'administration lui-même. Dépend de ULib. |
Option A — Collection Workshop (Recommandé)
Ajoutez les deux Workshop ID à la collection Workshop de votre serveur. Si vous avez déjà une collection configurée via +host_workshop_collection dans GPanel, ajoutez simplement ULib et ULX à cette collection existante sur Steam. Le serveur les téléchargera automatiquement au prochain redémarrage.
Option B — Téléversement manuel via SFTP
- Téléchargez les deux addons depuis le Workshop ou depuis le GitHub de Team Ulysses.
- Téléversez-les via SFTP sur votre serveur de sorte que la structure des dossiers soit :
garrysmod/addons/ulib/
garrysmod/addons/ulx/
Chaque dossier doit contenir le répertoire lua/ de l'addon directement à l'intérieur.
2. S'attribuer le rang Superadmin
Une fois ULX installé et le serveur redémarré, vous devez vous attribuer le rang superadmin. Ouvrez la console du serveur dans GPanel et exécutez :
ulx adduser "YourSteamName" superadmin
Si votre nom Steam contient des caractères spéciaux ou des espaces, utilisez plutôt votre Steam ID 64 bits pour plus de précision :
ulx adduserid "STEAM_0:1:12345678" superadmin
STEAM_0:X:XXXXXXXX ou le format 64 bits 7656119XXXXXXXXXX.
Une fois le rang attribué, reconnectez-vous au serveur. Vous pouvez vérifier votre rang en tapant !menu dans le chat pour ouvrir l'interface d'administration ULX.
3. Commandes ULX courantes
Les commandes ULX peuvent être exécutées depuis la console du serveur dans GPanel, la console en jeu, ou en tant que commandes de chat (préfixées par !). Voici les commandes les plus couramment utilisées.
Gestion des joueurs
| Commande | Raccourci chat | Description |
|---|---|---|
ulx kick "Player" reason | !kick Player reason | Expulser un joueur du serveur |
ulx ban "Player" minutes reason | !ban Player 60 reason | Bannir un joueur (0 = permanent) |
ulx unban STEAMID | !unban STEAMID | Débannir un joueur par Steam ID |
ulx slay "Player" | !slay Player | Tuer un joueur instantanément |
ulx slap "Player" damage | !slap Player 10 | Frapper un joueur pour les dégâts spécifiés |
Contrôles de communication
| Commande | Raccourci chat | Description |
|---|---|---|
ulx gag "Player" | !gag Player | Empêcher un joueur d'utiliser le chat vocal |
ulx ungag "Player" | !ungag Player | Rétablir le chat vocal pour un joueur |
ulx mute "Player" | !mute Player | Empêcher un joueur d'utiliser le chat textuel |
ulx unmute "Player" | !unmute Player | Rétablir le chat textuel pour un joueur |
Commandes utilitaires
| Commande | Raccourci chat | Description |
|---|---|---|
ulx noclip "Player" | !noclip Player | Activer/désactiver le noclip (traverser les murs) |
ulx god "Player" | !god Player | Activer/désactiver le mode dieu (invincibilité) |
ulx teleport "Player" | !tp Player | Téléporter un joueur vers votre viseur |
ulx bring "Player" | !bring Player | Téléporter un joueur vers vous |
ulx goto "Player" | !goto Player | Se téléporter vers un joueur |
ulx return "Player" | !return Player | Renvoyer un joueur à sa position précédente |
ulx cloak "Player" | !cloak Player | Rendre un joueur invisible |
4. Groupes de permissions
ULX utilise un système de permissions basé sur les groupes. Par défaut, ULX inclut ces groupes, classés du plus privilégié au moins privilégié :
| Groupe | Hérite de | Utilisation typique |
|---|---|---|
superadmin | admin | Propriétaire du serveur. Accès complet à toutes les commandes. |
admin | operator | Personnel de confiance. Peut bannir, expulser, gérer les joueurs. |
operator | user | Modérateurs juniors. Commandes de modération limitées. |
user | aucun | Groupe par défaut pour tous les joueurs. |
Gestion des utilisateurs et des groupes
// Add a user to a group
ulx adduser "Player" admin
// Remove a user from their group (reverts to "user")
ulx removeuser "Player"
// Create a custom group that inherits from "operator"
ulx groupallow "moderator" "ulx kick"
ulx addgroup "moderator" "operator"
// Grant a specific command to a group
ulx groupallow "admin" "ulx ban"
// Deny a specific command from a group
ulx groupdeny "operator" "ulx ban"
Utilisation de l'interface graphique
En tant que superadmin, tapez !menu dans le chat pour ouvrir le panneau d'administration ULX. L'onglet Groups fournit une interface visuelle pour créer des groupes, attribuer des permissions et gérer les utilisateurs sans commandes console.
garrysmod/data/ulib/groups.txt et les données des utilisateurs dans garrysmod/data/ulib/users.txt. Ces fichiers sont gérés automatiquement par ULX, mais vous pouvez les sauvegarder via SFTP.
5. Commandes de chat
ULX prend en charge les raccourcis de commandes par chat pour une administration rapide en jeu. Toutes les commandes utilisent le préfixe ! par défaut. Quelques modèles utiles :
| Commande de chat | Effet |
|---|---|
!menu | Ouvre l'interface d'administration ULX |
!motd | Affiche le message du jour |
!kick Player reason | Expulse le joueur nommé |
!ban Player 60 reason | Bannit pour 60 minutes |
!hp Player 100 | Définit les points de vie d'un joueur |
!armor Player 100 | Définit l'armure d'un joueur |
@ comme cible pour appliquer une commande à vous-même. Par exemple, !god @ active/désactive le mode dieu sur vous-même.
6. Fichiers de configuration
ULX stocke sa configuration et ses données dans garrysmod/data/ulib/. Fichiers importants à connaître :
| Fichier | Fonction |
|---|---|
data/ulib/users.txt | Toutes les attributions utilisateur-groupe et les Steam ID |
data/ulib/groups.txt | Définitions des groupes, héritage et permissions |
data/ulib/bans.txt | Liste des bannissements actifs avec les délais d'expiration |
data/ulx/config.txt | Paramètres ULX (MOTD, message de bienvenue, journalisation, etc.) |
data/ulib/ et data/ulx/ via SFTP en tant que sauvegarde. Un fichier de groupes mal configuré peut bloquer l'accès de tous les administrateurs.
Articles connexes
- Guide de configuration du serveur Garry's Mod — Server.cfg, Workshop, modes de jeu, DarkRP, FastDL
- Dépannage Garry's Mod — Textures manquantes, erreurs Workshop et plus
- Comment téléverser des fichiers via SFTP