Comment devenir admin sur votre serveur FiveM avec les permissions ACE ?

Votre serveur FiveM tourne et vous pouvez vous connecter via F8, mais en jeu vous êtes encore un joueur ordinaire : pas de kick, pas de ban, pas de menu admin. Dans ce guide, vous devenez admin (vous et les membres de votre équipe) par deux voies complémentaires : les admins txAdmin pour la gestion web et les permissions ACE dans server.cfg pour les droits dans le serveur lui-même. Voyez-y l'équivalent FiveM de notre guide LuckPerms pour Minecraft.

txAdmin ou ACE : quand utiliser quoi ?

txAdmin est le panneau web avec lequel vous gérez le serveur : liste des joueurs, console en direct, bans, redémarrages planifiés. Un admin txAdmin se connecte via le navigateur et n'a même pas besoin d'être en jeu. Les permissions ACE déterminent ce qu'un joueur peut faire dans le serveur : quelles commandes il peut exécuter et quelles fonctions protégées des ressources (comme un menu admin) fonctionnent pour lui. Un administrateur complet a généralement besoin des deux.

Voie 1 : ajouter un admin dans txAdmin

1. Ouvrez l'interface txAdmin dans votre navigateur et connectez-vous avec votre compte master (créé lors de la configuration initiale). Si txAdmin ne tourne pas encore, suivez d'abord notre guide pour activer txAdmin.
2. Allez dans Admins dans le menu et cliquez sur New Admin.
3. Choisissez un nom d'utilisateur et renseignez éventuellement le nom d'utilisateur Cfx.re et l'ID Discord du nouvel admin. Grâce à cette liaison, il pourra désormais se connecter via le bouton Cfx.re ou Discord au lieu d'un mot de passe.
4. Ne cochez que les permissions dont le rôle a réellement besoin. Pour un modérateur, la gestion des joueurs (kick, warn, ban) suffit ; gardez pour vous les réglages, la console en direct et la gestion des autres admins.
5. Enregistrez et partagez le mot de passe temporaire affiché par txAdmin. À la première connexion, le nouvel admin choisit son propre mot de passe.

Trouver votre propre identifier (license, steam ou discord)

Les permissions ACE se rattachent à un identifier : un code unique grâce auquel FiveM reconnaît votre compte. Voici comment le trouver :

1. Connectez-vous au moins une fois à votre propre serveur, pour qu'il connaisse vos identifiers.
2. Dans txAdmin, ouvrez la page Players, cliquez sur votre propre nom et consultez vos ID. Vous y verrez entre autres license:, discord: et (si Steam tournait pendant la connexion) steam:.
3. Vous n'utilisez pas txAdmin ? Tapez status dans la console du serveur (onglet Console du panneau de jeu) ; chaque joueur connecté y figure avec un identifier.

Privilégiez l'identifier license : il est toujours présent et ne change jamais. La variante steam manque si Steam n'était pas ouvert, et discord n'apparaît que si Discord était actif pendant la connexion.

Voie 2 : configurer les permissions ACE dans server.cfg

1. Dans le panneau de jeu, ouvrez l'onglet Files et naviguez jusqu'au server.cfg que votre serveur charge réellement. Sur un déploiement txAdmin, il se trouve généralement dans un sous-dossier de txData. Ce fichier est nouveau pour vous ? Lisez d'abord nos bases du server.cfg.
2. Collez le bloc ci-dessous à la fin du fichier et remplacez les identifiers d'exemple par vos propres valeurs.
3. Enregistrez le fichier et redémarrez le serveur via l'onglet Console (ou via txAdmin). Les lignes ACE ne sont lues qu'au démarrage.
4. Testez en jeu que vos droits admin fonctionnent, par exemple avec le menu admin de votre framework.

# --- Admins (permissions ACE) ---
add_ace group.admin command allow            # les admins peuvent utiliser toutes les commandes console
add_ace group.admin command.quit deny        # mais arrêter le serveur reste réservé au panneau

# Les modérateurs n'obtiennent que ce que vous autorisez explicitement ici
add_ace group.mod command.clientkick allow   # les modérateurs peuvent kick des joueurs

# Hiérarchie : chaque admin hérite automatiquement de tous les droits mod
add_principal group.admin group.mod

# Rattacher des joueurs aux groupes (notez le préfixe identifier.)
add_principal identifier.license:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b group.admin  # VotreNom
add_principal identifier.discord:123456789012345678 group.mod                          # NomDuModerateur

Voici comment fonctionne la hiérarchie : add_ace accorde un droit à un principal (comme le groupe group.admin), et add_principal X Y signifie « X hérite de tous les droits de Y ». Avec add_principal group.admin group.mod, les admins héritent donc de tout ce que les mods peuvent faire — pas l'inverse. Vous rendez un joueur admin en rattachant son identifier à group.admin avec add_principal. Soyez économe en lignes add_ace … allow supplémentaires : n'accordez à une ressource que l'ace exacte mentionnée dans sa documentation, et n'accordez jamais à builtin.everyone (tous les joueurs) plus de droits que strictement nécessaire.

Problèmes fréquents

• Les permissions disparaissent après un redémarrage — Vous avez tapé add_ace ou add_principal dans la console en direct (valable seulement jusqu'au redémarrage) ou dans un fichier que le serveur ne charge pas. Placez les lignes dans le server.cfg que txAdmin utilise vraiment ; son chemin est visible dans les réglages de txAdmin.
• Identifier mal formaté — Dans add_principal, le préfixe identifier. se place devant la valeur, sans espaces : donc identifier.license:…. Une license compte 40 caractères hexadécimaux, un identifier Discord est l'ID numérique (pas votre nom d'utilisateur) et un identifier steam est la valeur hexadécimale affichée par le serveur, pas votre SteamID64.
• « You do not have permission » malgré group.admin — Des frameworks comme ESX et QBCore gèrent en plus leur propre groupe admin dans la base de données ou la config. ACE couvre les commandes serveur ; pour les fonctions du framework, vérifiez aussi les permissions du framework lui-même.
• Tout le monde peut soudain utiliser les commandes admin — Quelque part se trouve une règle trop large, comme command allow sur builtin.everyone ou un allow global ajouté par l'installation d'une ressource. Cherchez add_ace dans vos fichiers cfg et supprimez ce que vous n'avez pas autorisé sciemment.
• La connexion à txAdmin via Cfx.re ou Discord échoue — Vérifiez que le nom d'utilisateur Cfx.re correspond exactement et que l'ID Discord est bien le nombre de 17 à 19 chiffres. Vous pouvez toujours vous connecter avec nom d'utilisateur et mot de passe.

Besoin d'aide ?

Avec un compte txAdmin et un groupe ACE propre dans server.cfg, votre structure d'administration est prête pour durer. Toujours bloqué ? Ouvrez un ticket via notre page de support en indiquant le nom de votre serveur et les lignes ajoutées — ne partagez jamais votre license key.