FiveMPublié le 6 février 2026Lecture 14 min

Comment configurer les permissions ACE sur FiveM

Les permissions ACE décident qui peut faire quoi sur votre serveur FiveM. Elles donnent les commandes d'admin à votre équipe, réservent un menu à la police et protègent les commandes sensibles. Ce guide explique le système, donne des configurations prêtes à copier et montre comment les tester pour sécuriser votre serveur.

Les permissions se placent dans le fichier server.cfg, que vous modifiez depuis OuiPanel, le panel de jeu de OuiHeberg. Elles s'écrivent de la même façon sur les deux éditions de FiveM proposées par OuiPanel, Legacy et Enhanced. Seule la partie txAdmin est réservée à Legacy.


Le système ACE, c'est quoi exactement ?

ACE (Access Control Entry) est le système de permissions intégré à FiveM. Avec lui, vous pouvez :

  • contrôler l'accès aux commandes et aux fonctions de vos scripts ;

  • créer des groupes avec des niveaux de droits différents ;

  • faire hériter un groupe d'un autre, pour qu'un admin ait aussi les droits d'un modérateur ;

  • protéger les commandes et les ressources sensibles.

Tout se configure dans le fichier server.cfg de votre serveur. Pour un essai, les mêmes lignes se tapent aussi dans la console.


Les trois concepts à comprendre

Trois notions suffisent pour lire n'importe quelle ligne de permission.

Le principal, c'est l'identité

Le principal désigne un joueur ou un groupe. Pour un joueur, c'est l'un de ses identifiants, précédé de identifier.. Pour un groupe, c'est son nom, précédé de group..

identifier.steam:110000xxxxxx    # Identifiant Steam
identifier.license:xxxxxx        # Licence Rockstar
identifier.discord:xxxxxx        # ID Discord
identifier.fivem:xxxxxx          # ID FiveM (compte Cfx.re)
group.admin                      # Un groupe

FiveM fournit aussi le principal builtin.everyone. Il désigne tout le monde, vous compris.

L'ACE, c'est la permission

L'ACE porte sur un objet, que vous autorisez ou refusez. Une commande s'écrit command. suivi de son nom. Les autres objets portent le nom que leur donne le script qui les vérifie.

command.kick          # Permission de kick
command.ban           # Permission de ban
police.armory         # Objet vérifié par un script

Un objet couvre aussi tout ce qui commence par son nom suivi d'un point. Ainsi, command couvre toutes les commandes, et police couvre police.menu comme police.armory. La casse ne compte pas, car FiveM écrit tout en minuscules.

Allow et deny

Vous autorisez (allow) ou refusez (deny) un objet à un principal. Quand un joueur agit, FiveM réunit ses identifiants, ses groupes et les groupes dont ils héritent. Il lit ensuite les règles posées sur l'objet et sur ses parents.

  • Un seul deny trouvé, et l'action est refusée, quels que soient les allow.

  • Sinon, un seul allow suffit à l'autoriser.

  • Sans aucune règle, l'action est refusée. Un joueur n'a donc aucun droit tant que vous ne lui en donnez pas.

Un deny posé sur builtin.everyone s'applique à tout le monde, vos admins compris. Aucun allow ne peut le lever.


L'héritage entre groupes

C'est ce qui rend le système ACE vraiment pratique. Un groupe peut hériter des permissions d'un autre groupe. Prenons cette hiérarchie.

superadmin → admin → moderateur → support

Un superadmin a toutes les permissions d'admin, qui a toutes celles de modérateur, et ainsi de suite. Vous n'avez pas besoin de recopier les mêmes permissions partout. L'héritage s'écrit avec add_principal, le groupe enfant d'abord, puis le groupe parent.

# L'admin hérite du modérateur, qui hérite du support
add_principal group.admin group.moderator
add_principal group.moderator group.support

L'héritage vaut aussi pour les refus. Un deny posé sur group.support s'applique au modérateur, à l'admin et au superadmin.

La ligne add_ace group.admin group.moderator allow ne crée aucun héritage. Elle donne au groupe admin un objet nommé group.moderator, qui ne sert à rien. L'héritage passe toujours par add_principal.


La syntaxe de base

Quatre commandes suffisent. Elles s'écrivent dans server.cfg, une par ligne.

# Donner ou refuser une permission à un groupe ou un joueur
add_ace <principal> <permission> <allow/deny>

# Ajouter un joueur à un groupe
add_principal <identifier> <group>

# Faire hériter un groupe d'un autre (enfant, puis parent)
add_principal group.admin group.moderator

# Retirer une permission ou un héritage
remove_ace <principal> <permission> <allow/deny>
remove_principal <identifier> <group>

Tapées dans la console du serveur, ces commandes prennent effet tout de suite. Elles disparaissent au redémarrage suivant si elles ne sont pas dans server.cfg. La documentation officielle de FiveM les décrit aussi.


Ouvrir server.cfg dans OuiPanel

Le fichier server.cfg est à la racine de votre serveur. Vous le modifiez dans le Gestionnaire de fichiers de OuiPanel.

  1. Connectez-vous à OuiPanel sur dash.ouipanel.com et ouvrez votre serveur.

  2. Dans la Console, arrêtez le serveur avec le bouton Arrêter.

  3. Dans le menu latéral, cliquez sur Gestionnaire de fichiers, puis sur server.cfg. La fenêtre « Édition de server.cfg » s'ouvre.

  4. Ajoutez vos lignes de permissions, puis cliquez sur Sauvegarder.

  5. Redémarrez le serveur depuis la Console.

Laissez telles quelles les lignes placées sous ### AUTOMATICALLY SET BY PTERODACTYL ###, en tête du fichier. Elles sont écrites par le panel. Le guide Comment configurer server.cfg sur son serveur FiveM présente le reste du fichier.

Fenêtre Édition de server.cfg ouverte dans le Gestionnaire de fichiers avec le bouton Sauvegarder


Configuration simple pour un seul admin

Vous débutez et voulez seulement vous donner les droits d'admin ? Voici le minimum.

# Créer le groupe admin avec toutes les commandes
add_ace group.admin command allow
# Sauf quit, qui éteint le serveur
add_ace group.admin command.quit deny

# Vous ajouter au groupe admin (remplacez par votre licence)
add_principal identifier.license:xxxxxxxxxxxxxx group.admin

Ce sont les lignes de l'exemple officiel de FiveM. Vous avez accès à toutes les commandes, sauf quit. C'est simple, mais peu fin pour une équipe. La partie suivante répartit les droits entre plusieurs groupes.


Configuration complète : structure hiérarchique

Voici une configuration plus sérieuse, avec quatre niveaux de droits et un groupe VIP. Chaque niveau hérite du niveau du dessous et ajoute ses propres commandes.

####################################
# SUPERADMIN (propriétaire du serveur)
####################################

# Toutes les commandes, plus les droits des admins
add_ace group.superadmin command allow
add_principal group.superadmin group.admin
add_principal identifier.steam:110000xxxxxx group.superadmin

####################################
# ADMIN
####################################

# L'admin hérite des droits modérateur
add_principal group.admin group.moderator

# Permissions spécifiques admin
add_ace group.admin command.restart allow
add_ace group.admin command.stop allow
add_ace group.admin command.start allow
add_ace group.admin command.refresh allow
add_ace group.admin command.ensure allow
add_ace group.admin command.setjob allow
add_ace group.admin command.giveitem allow
add_ace group.admin command.givemoney allow
add_ace group.admin command.car allow
add_ace group.admin command.dv allow
add_ace group.admin command.tp allow
add_ace group.admin command.bring allow
add_ace group.admin command.unban allow

add_principal identifier.steam:110000yyyyyy group.admin

####################################
# MODERATEUR
####################################

# Le modérateur hérite des droits support
add_principal group.moderator group.support

# Permissions de modération
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow
add_ace group.moderator command.warn allow
add_ace group.moderator command.mute allow
add_ace group.moderator command.spectate allow
add_ace group.moderator command.goto allow
add_ace group.moderator command.announce allow

add_principal identifier.steam:110000zzzzzz group.moderator
add_principal identifier.discord:123456789 group.moderator

####################################
# SUPPORT
####################################

add_ace group.support command.tp allow
add_ace group.support command.tpto allow
add_ace group.support command.bring allow
add_ace group.support command.revive allow

add_principal identifier.steam:110000aaaaaa group.support

####################################
# VIP (avantages sans droits admin)
####################################

add_ace group.vip vip.priority allow
add_ace group.vip vip.customskin allow
add_ace group.vip vip.spawnvehicle allow

add_principal identifier.steam:110000bbbbbb group.vip

Les commandes comme setjob, car ou revive viennent de vos ressources. Elles n'existent que si une ressource les déclare. Les identifiants Steam de l'exemple supposent que vos joueurs ont lié un compte Steam, comme l'explique la partie suivante.

N'ajoutez pas de deny sur builtin.everyone pour protéger restart, stop ou exec. Ce refus s'appliquerait aussi à vos admins. Un joueur n'a de toute façon aucune de ces commandes tant que vous ne la lui donnez pas.


Les différents types d'identifiants

Un joueur se reconnaît à plusieurs identifiants. Chacun s'écrit identifier., puis le type et la valeur. La page GetPlayerIdentifiers de la documentation de FiveM liste tous les types.

Licence Rockstar (recommandée)

La licence vient du compte Rockstar du joueur, que FiveM exige. C'est l'identifiant le plus sûr pour vos admins.

add_principal identifier.license:xxxxxxxxxxxxxx group.admin

Steam ID

L'identifiant Steam reste très utilisé. Il n'existe que si le joueur a lié un compte Steam à son compte Cfx.re.

add_principal identifier.steam:110000xxxxxx group.admin

Pour l'exiger de tous les joueurs, ajoutez set sv_enforceSteamAuth true dans server.cfg. Un joueur sans compte Steam lié devra en lier un pour entrer. Ce réglage demande un serveur en build 38004 ou plus récent. Il remplace steam_webApiKey, qui n'a plus d'effet depuis le 4 novembre 2026.

Discord ID

add_principal identifier.discord:123456789012345678 group.admin

Pour le trouver, activez le mode développeur dans les paramètres avancés de Discord. Faites ensuite un clic droit sur l'utilisateur et copiez son identifiant.

FiveM ID

add_principal identifier.fivem:xxxxxx group.admin

C'est le numéro du compte Cfx.re du joueur. L'exemple officiel de FiveM s'en sert pour déclarer son premier admin.

L'identification par IP (identifier.ip:xxx) est déconseillée, car les adresses IP changent régulièrement.

Trouver l'identifiant d'un joueur

La commande status, tapée dans la console du serveur, liste les joueurs connectés avec leur identifiant principal, leur numéro et leur nom. Elle vient de la ressource rconlog, qui doit être démarrée.

Un identifiant Steam se retrouve sur SteamID.io. FiveM attend sa forme hexadécimale, qui commence par 110000.


Permissions pour les métiers (serveur RP)

Sur un serveur roleplay, vous pouvez créer des permissions propres à chaque métier. Les noms d'objets comme police.armory sont libres. Ils n'ont d'effet que si un script les vérifie.

# Police
add_ace group.police police.menu allow
add_ace group.police police.armory allow
add_ace group.police police.handcuff allow
add_ace group.police police.vehicle allow

# EMS
add_ace group.ems ems.menu allow
add_ace group.ems ems.vehicle allow
add_ace group.ems command.revive allow
add_ace group.ems command.heal allow

# Mécano
add_ace group.mechanic mechanic.menu allow
add_ace group.mechanic mechanic.repair allow

Un joueur entre dans un groupe de métier avec add_principal, comme un admin. Pour donner d'un coup tous les objets qui commencent par police., une seule ligne add_ace suffit.

add_principal identifier.license:xxxxxxxxxxxxxx group.police
add_ace group.police police allow

Dans vos scripts serveur, vous vérifiez ensuite la permission avec IsPlayerAceAllowed.

if IsPlayerAceAllowed(source, 'police.armory') then
    -- Le joueur peut accéder à l'armurerie
end

Cette fonction n'existe que côté serveur. Sa fiche est dans la liste des natives de FiveM.


Restreindre l'accès à une ressource

FiveM ne ferme pas une ressource entière à un joueur. Il contrôle ce que la ressource propose, c'est-à-dire ses commandes et les objets que ses scripts vérifient.

Une commande déclarée restreinte par son script demande la permission command. suivie de son nom. Dans le script, c'est le troisième argument de RegisterCommand.

-- Script serveur : la commande menuadmin est restreinte
RegisterCommand('menuadmin', function(source, args)
    -- ouvre le menu
end, true)
# Seuls les admins peuvent taper /menuadmin
add_ace group.admin command.menuadmin allow

Avec false à la place de true, tout le monde peut utiliser la commande. Pour un menu sans commande, le script doit vérifier lui-même un objet avec IsPlayerAceAllowed, comme pour les métiers.

Donner des droits à une ressource

Le principal resource. suivi d'un nom désigne la ressource elle-même. Il sert quand un script doit lancer des commandes du serveur. ESX en a besoin, par exemple.

add_ace resource.es_extended command.add_principal allow

Les lignes add_ace builtin.everyone resource.admin_menu deny et add_ace group.admin resource.admin_menu allow ne protègent rien. FiveM ne vérifie pas de lui-même un objet resource.admin_menu, et un deny sur builtin.everyone vaut aussi pour vos admins.


Les droits dans txAdmin

txAdmin, l'interface web d'administration de FiveM, n'existe que sur l'édition Legacy dans OuiPanel. Pour le vérifier, cliquez sur Configuration FiveM dans le menu latéral. Dans la carte Canal FiveM, le badge Actuel doit être sur Legacy.

Page Configuration FiveM avec la carte Canal FiveM et le badge Actuel sur Legacy

txAdmin ne passe pas par ACE. Il a ses propres comptes d'admin et ses propres permissions, enregistrés dans txData/admins.json. Vous les réglez dans sa page Admin Manager. Des lignes comme add_ace group.superadmin txadmin allow n'y changent rien.

Permission txAdminCe qu'elle permet
all_permissionsToutes les actions
manage.adminsCréer, modifier et supprimer des comptes d'admin
console.viewVoir la console
console.writeTaper des commandes dans la console
control.serverDémarrer, arrêter et redémarrer le serveur
commands.resourcesDémarrer et arrêter des ressources
server.cfg.editorLire et modifier server.cfg
players.kickExpulser un joueur
players.banBannir ou débannir un joueur
players.whitelistAjouter un joueur à la whitelist

La liste complète est dans la documentation de txAdmin. Pour activer txAdmin et vous y connecter depuis OuiPanel, suivez le guide Créer une whitelist FiveM avec Discord et txAdmin.


Intégration avec ESX et QBCore

Avec ESX

ESX Legacy range chaque joueur dans un groupe enregistré dans sa base de données. À la connexion du joueur, ESX l'ajoute lui-même au groupe ACE du même nom, avec sa licence. Pour cela, server.cfg doit autoriser es_extended à lancer ces commandes. Ces lignes figurent dans le server.cfg fourni par ESX.

add_principal group.admin group.user
add_ace resource.es_extended command.add_ace allow
add_ace resource.es_extended command.add_principal allow
add_ace resource.es_extended command.remove_principal allow
add_ace resource.es_extended command.stop allow

Vous donnez ensuite vos commandes au groupe admin, comme d'habitude.

add_ace group.admin command.setjob allow
add_ace group.admin command.givemoney allow
add_principal identifier.steam:xxx group.admin

N'oubliez pas de mettre aussi le groupe à admin dans la table users de votre base de données ESX. ESX lit ce groupe pour ses propres vérifications.

Avec QBCore

QBCore déclare ses niveaux de droits dans qb-core/config.lua. Par défaut, ce sont god, admin et mod. Chaque niveau correspond à un principal qbcore. suivi de son nom.

QBCore.Config.Server.Permissions = { 'god', 'admin', 'mod' }

Le server.cfg fourni par QBCore relie ces niveaux entre eux. Il ne reste qu'à vous ajouter au niveau god.

# Lignes du server.cfg fourni par QBCore
add_ace resource.qb-core command allow
add_ace qbcore.god command allow
add_principal qbcore.god group.admin
add_principal qbcore.god qbcore.admin
add_principal qbcore.admin qbcore.mod

# Vous donner le niveau god (remplacez par votre licence)
add_principal identifier.license:xxxxxxxxxxxxxx qbcore.god

Un god a toutes les commandes et hérite des niveaux admin et mod. Les commandes de QBCore réservées à un niveau vérifient ces principaux.


Commandes utiles pour tester

Ces commandes se tapent dans la console du serveur. Dans OuiPanel, ouvrez la Console, écrivez la commande dans le champ « Tapez une commande, sans la barre oblique », puis cliquez sur Envoyer. Dans la console F8 du jeu, elles ne voient pas les permissions du serveur.

Console d'un serveur FiveM en marche avec le champ de commande et le bouton Envoyer

Vérifier si un joueur a une permission

test_ace identifier.steam:110000xxxxxx command.kick

La console répond true ou false, sous la forme identifier.steam:110000xxxxxx -> command.kick = true. Le premier argument est un principal complet, avec identifier. devant. Le joueur n'a pas besoin d'être connecté. Vous pouvez aussi tester un groupe, avec test_ace group.admin command.kick.

Lister toutes les permissions actives

list_aces
list_principals

list_aces affiche chaque règle, comme group.admin -> command = ALLOW. list_principals affiche les héritages et les membres des groupes, comme group.admin <- group.moderator.

Suivre chaque vérification

set se_debug true

La console écrit alors le résultat de chaque vérification de droits. Remettez set se_debug false une fois le problème trouvé, car la console se remplit vite.


Résoudre les problèmes courants

Les permissions ne s'appliquent pas

  • Redémarrez complètement le serveur. refresh ne relit que la liste des ressources, pas server.cfg.

  • Vérifiez chaque identifiant. Il faut le préfixe identifier. et le bon type (license:, steam:, discord:). La casse, elle, ne compte pas.

  • Utilisez status pour voir les identifiants des joueurs connectés, puis testez la ligne avec test_ace.

  • Un script peut lire les droits une seule fois, à la connexion du joueur. Dans le doute, faites-le se reconnecter.

L'ordre des lignes ne compte pas

Vous pouvez écrire add_principal avant ou après add_ace. FiveM vérifie les droits au moment où le joueur agit, quand tout le fichier a déjà été lu. Ces deux blocs donnent le même résultat.

# Joueur déclaré avant le groupe
add_principal identifier.steam:xxx group.admin
add_ace group.admin command allow

# Groupe déclaré avant le joueur
add_ace group.admin command allow
add_principal identifier.steam:xxx group.admin

Un admin est refusé malgré son groupe

Cherchez un deny qui le concerne avec list_aces. Un refus posé sur builtin.everyone, ou sur un groupe dont il hérite, l'emporte sur tous ses allow. Des lignes comme celles-ci bloquent tout le monde, admins compris. Retirez-les.

add_ace builtin.everyone command.restart deny
add_ace builtin.everyone command.stop deny
add_ace builtin.everyone command.exec deny

Conflit avec ESX/QBCore

Si une commande est refusée malgré les bonnes permissions ACE, le script lui-même peut avoir son propre système de vérification. Vérifiez la configuration du script concerné.


Bonnes pratiques de sécurité

Principe du moindre privilège

Ne donnez que les permissions strictement nécessaires.

# Trop large
add_ace group.moderator command allow

# Précis
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow
add_ace group.moderator command.warn allow

Protéger les commandes critiques

Réservez restart, stop et exec au groupe du haut. Évitez de donner command en bloc à un groupe dont d'autres héritent. Si vous le faites quand même, retirez-lui les commandes dangereuses avec un deny posé sur ce groupe. Ce refus touchera aussi les groupes qui en héritent.

# Autoriser uniquement les superadmins
add_ace group.superadmin command.restart allow
add_ace group.superadmin command.stop allow

Documentez votre configuration

Commentez votre server.cfg pour vous y retrouver.

# ===== GROUPE ADMIN =====
# Peut gérer les joueurs et les ressources
# Ne peut PAS arrêter/redémarrer le serveur
add_ace group.admin command.kick allow
# ...

Besoin d'aide ?

Ouvrez un ticket depuis Tickets › Ouvrir un ticket, ou depuis la tuile Contacter le support en bas de la fiche de votre serveur dans l'espace client. Vous pouvez aussi poser votre question sur le Discord de OuiHeberg.

Cet article vous a-t-il aidé ?

1 938 vues
Partager cet article
FiveM
Besoin d'un serveur GTA/FiveM ?

Découvrez nos offres d'hébergement GTA V / FiveM dès 2,99 €/mois, serveur prêt en 60 secondes.

Voir les offres →

Articles connexes