FR

Serveurs de jeux

Comment gérer les permissions ACE sur FiveM

Comprenez les ACE et les principals de FiveM, créez des groupes d'administration dans un fichier dédié, testez chaque droit depuis la console et corrigez les erreurs Access denied.

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

Sur cette page

FXServer contrôle l'accès aux commandes avec un système d'ACE (access control entries) et de principals. Ce guide vous explique comment il décide, comment créer vos groupes dans un fichier séparé, comment tester chaque droit et comment retirer un accès.

Prérequis

  • Un serveur installé avec le guide Créer un serveur FiveM
  • Un accès à txAdmin, pour Live Console, CFG Editor et la liste des joueurs
  • L'identifiant du joueur à qui vous voulez donner des droits

Les notions à connaître

Une règle se lit ainsi : tel principal a le droit, ou non, d'accéder à tel objet.

Notion Rôle Exemples
Principal Qui reçoit le droit group.admin, identifier.license:abc123, resource.es_extended
Objet Ce qui est protégé command, command.quit, monserveur.garage
ACE Une règle allow ou deny add_ace group.admin command allow
Héritage Un principal reçoit les droits d'un autre add_principal identifier.license:abc123 group.admin

Les principals les plus courants :

Principal Désigne
identifier.license:... Un joueur, par sa licence Rockstar. C'est l'identifiant le plus sûr à utiliser
identifier.fivem:... Un joueur, par son compte Cfx.re
identifier.discord:... Un joueur, par son compte Discord, seulement si Discord est détecté à sa connexion
player.1 Le joueur numéro 1 de la session en cours. Ce numéro change à chaque connexion
group.nom Un groupe que vous définissez librement
resource.nom Une ressource, quand elle exécute elle-même une commande
builtin.everyone Tout le monde

Comment FXServer décide

Quatre règles suffisent à prévoir le résultat :

  1. Sans règle, c'est refusé. Un principal n'a accès à rien par défaut.
  2. Un droit couvre ses sous-objets. command couvre command.quit, et monserveur.garage couvre monserveur.garage.ouvrir.
  3. Un deny l'emporte sur un allow, quel que soit l'ordre des lignes.
  4. Un joueur est évalué identifiant par identifiant. Il suffit qu'un seul de ses identifiants soit autorisé pour qu'il ait accès.

La quatrième règle a une conséquence importante : un deny posé sur identifier.license:abc123 n'empêche pas l'accès si identifier.fivem:42, du même joueur, est autorisé. Pour retirer un droit à un joueur, retirez-le du groupe plutôt que d'ajouter un deny.

Étape 1 : relever l'identifiant du joueur

Le joueur doit s'être déjà connecté au serveur. Dans txAdmin, ouvrez sa fiche depuis la liste des joueurs, puis l'onglet IDs. Vous y trouvez des valeurs comme license:abc123 ou fivem:42.

Pour FXServer, ajoutez le préfixe identifier. : license:abc123 devient identifier.license:abc123.

Étape 2 : créer un fichier de permissions

Un fichier séparé garde server.cfg lisible. Repérez le dossier du serveur, dont le nom se termine par .base. Si plusieurs dossiers apparaissent, le bon est indiqué par Server Data Folder, dans Settings, onglet FXServer :

Terminal
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'

Ouvrez une session fivem, sauvegardez la configuration, puis créez le fichier :

Terminal
sudo -iu fivem
BASE=/home/fivem/txData/NOM_DU_DOSSIER.base
cp "$BASE/server.cfg" "$BASE/server.cfg.avant-permissions"
nano "$BASE/permissions.cfg"

Exemple avec un groupe de modération et un groupe d'administration, à adapter :

Texte
# Droits des modérateurs
add_ace group.moderator command.clientkick allow
add_ace group.moderator command.say allow

# Les administrateurs héritent des modérateurs
add_principal group.admin group.moderator

# Droits des administrateurs
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Membres de l'équipe
add_principal identifier.license:LICENCE_DU_MODERATEUR group.moderator
add_principal identifier.license:LICENCE_DE_L_ADMIN group.admin

Quittez la session avec exit.

Étape 3 : charger le fichier

Dans CFG Editor, ajoutez cette ligne à côté des permissions déjà présentes :

Texte
exec permissions.cfg

Le chemin est relatif au dossier du serveur. Enregistrez, puis appliquez le fichier sans redémarrer en tapant la même commande dans Live Console. Il sera de toute façon relu au prochain démarrage.

Un joueur connecté reçoit ses nouveaux droits immédiatement, sans se reconnecter.

Étape 4 : tester les droits

Toutes ces commandes se tapent dans Live Console. test_ace répond true ou false :

Texte
test_ace identifier.license:LICENCE_DU_MODERATEUR command.clientkick
test_ace identifier.license:LICENCE_DU_MODERATEUR command.quit
test_ace group.admin command.quit

Avec l'exemple ci-dessus, vous devez obtenir true, false puis false. La réponse a cette forme :

Texte
identifier.license:LICENCE_DU_MODERATEUR -> command.clientkick = true

Pour afficher tout ce qui est chargé :

Texte
list_principals
list_aces

list_principals affiche enfant <- parent, et list_aces affiche principal -> objet = ALLOW ou DENY.

Si un résultat vous surprend, activez le suivi détaillé, refaites l'action, puis désactivez-le :

Texte
se_debug true
se_debug false

La console indique alors chaque règle consultée, avec des lignes TEST ACL [...] -> ALLOW ou DENY.

Autoriser une commande ou une ressource

Ouvrir une commande restreinte à tous les joueurs :

Texte
add_ace builtin.everyone command.macommande allow

Autoriser une ressource à lancer une commande. Quand une ressource utilise ExecuteCommand, c'est elle qui doit avoir le droit. Accordez uniquement la commande nécessaire :

Texte
add_ace resource.ma_ressource command.add_principal allow

Protéger une fonction de votre propre script. Créez un objet libre, puis testez-le côté serveur avec IsPlayerAceAllowed :

Texte
add_ace group.moderator monserveur.garage allow
lua
if IsPlayerAceAllowed(source, 'monserveur.garage') then
    -- action réservée
end

ACE et frameworks

Les frameworks s'appuient sur ce système, mais chacun a sa méthode. Ne retirez pas les lignes add_ace resource... ajoutées par leur recette : ils en ont besoin pour fonctionner.

ESX Legacy

Le groupe du joueur est stocké dans la colonne group de la table users. À chaque connexion, ESX ajoute automatiquement le joueur à group.<son groupe>. Changez donc le groupe avec la commande prévue, dans Live Console ou en jeu, le joueur étant connecté :

Texte
setgroup 1 admin

Ici, 1 est le numéro du joueur dans la session.

QBCore

QBCore utilise les niveaux god, admin et mod. Pour un droit durable, placez la licence dans permissions.cfg :

Texte
add_principal identifier.license:LICENCE_DU_JOUEUR qbcore.god

La commande en jeu /addpermission 1 god agit sur player.1 : elle est perdue dès que le joueur se déconnecte.

txAdmin

Les comptes de l'interface txAdmin sont indépendants des ACE. Leurs droits se gèrent dans Admins et sont stockés dans admins.json. Donner group.admin à un joueur ne lui donne donc pas accès à txAdmin, et inversement.

Retirer un droit

Supprimez la ligne de permissions.cfg, sinon le droit reviendra au prochain démarrage. Retirer une ligne ne suffit pas pour le serveur en cours, car les règles restent en mémoire. Tapez aussi dans Live Console :

Texte
remove_principal identifier.license:LICENCE_DU_MODERATEUR group.moderator
remove_ace group.moderator command.say allow

Vérifiez ensuite avec test_ace. Vous pouvez aussi redémarrer le serveur, ce qui repart uniquement des fichiers.

Pour annuler complètement vos changements, retirez la ligne exec permissions.cfg de CFG Editor, remettez au besoin la copie server.cfg.avant-permissions, puis redémarrez le serveur.

En cas de problème

Access denied for command

Le message Access denied for command xxx. indique qui n'a pas le droit selon le contexte :

  • Un joueur a lancé la commande : testez son identifiant avec test_ace identifier.license:... command.xxx.
  • Il apparaît au démarrage d'une ressource, ou sans action d'un joueur : c'est la ressource qui n'a pas le droit. Ajoutez add_ace resource.nom command.xxx allow.

Avec ESX, un message sur add_principal ou remove_principal signale souvent que les lignes add_ace resource.es_extended ... de la recette ont été retirées.

No such config file: permissions.cfg

Le fichier n'est pas dans le dossier du serveur, ou son nom est différent. Il doit se trouver à côté de server.cfg, et être lisible par l'utilisateur fivem. En cas de doute, corrigez le propriétaire :

Terminal
sudo chown fivem:fivem /home/fivem/txData/NOM_DU_DOSSIER.base/permissions.cfg

Access type needs to be 'allow' or 'deny'

La ligne add_ace ou remove_ace est mal écrite. Sa forme est add_ace principal objet allow, sans autre mot.

test_ace répond true, mais le joueur n'a pas accès

  • Vérifiez qu'il s'agit du même identifiant, dans l'onglet IDs de sa fiche.
  • N'utilisez pas identifier.discord si Discord n'était pas ouvert à sa connexion : préférez la licence.
  • Vérifiez que la commande se lance bien comme vous l'imaginez. Un menu ou un script peut appliquer ses propres contrôles en plus des ACE.

Un deny ne bloque pas le joueur

Le joueur est probablement autorisé par un autre de ses identifiants. Cherchez-les avec list_principals, puis retirez-le des groupes concernés.

Le droit a disparu après une reconnexion ou un redémarrage

Il a été donné avec player.N, ou tapé uniquement dans la console. Ajoutez-le à permissions.cfg avec identifier.license:....

Un droit retiré du fichier fonctionne encore

Les règles déjà chargées restent actives jusqu'au redémarrage. Utilisez remove_ace ou remove_principal, ou redémarrez le serveur.