Comment devenir administrateur sur FiveM : add_ace, add_principal, group.admin

Vous lancez votre propre serveur, vous vous y connectez, et les commandes administrateur ne font rien : pas de menu, pas de /car, le framework dit que vous n'avez pas les permissions. Vous possédez le serveur, mais le serveur ne le sait pas encore. Vous devez lui dire qui vous êtes.

FiveM dispose d'un système de permissions appelé ACE. Ce guide explique comment vous mettre dans le groupe administrateur, comment trouver votre identifiant, et quoi définir dans ESX et QBCore en plus.

#Comment fonctionne ACE

ACE (Access Control Entries) est intégré à FiveM. Deux choses importent :

• add_ace donne une permission à un groupe ou une personne, par exemple « le groupe admin peut exécuter n'importe quelle commande ».
• add_principal met une personne, ou un groupe, dans un autre groupe.

Le modèle habituel est : définir ce que le groupe administrateur peut faire, puis ajouter les joueurs au groupe avec leur identifiant. Tout cela va dans server.cfg.

#Étape 1 : définir le groupe administrateur

add_ace group.admin command allow
add_ace group.admin command.quit deny

La première ligne permet au groupe admin d'exécuter toutes les commandes. La deuxième supprime une commande dangereuse, pour qu'un administrateur ne puisse pas arrêter le serveur avec quit. Vous pouvez ajouter plus de lignes deny pour les commandes que vous ne voulez pas dans le groupe.

#Étape 2 : vous ajouter au groupe

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Remplacez la longue valeur par votre propre identifiant. Vous pouvez ajouter plusieurs joueurs, une ligne chacun :

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin
add_principal identifier.fivem:1234567 group.admin
add_principal identifier.discord:123456789012345678 group.admin

Le type d'identifiant va avant les deux points, et vous pouvez en utiliser n'importe lequel. Ils pointent tous vers la même personne, donc une ligne par personne suffit.

#Étape 3 : trouver vos identifiants

Vous avez besoin de votre identifiant du point de vue du serveur, donc connectez-vous une fois d'abord.

• Dans txAdmin : ouvrez la page Players, cliquez sur votre nom, et ouvrez les infos du joueur. Les identifiants sont listés là (license, fivem, discord, steam et autres).
• Dans la console du serveur : tapez status. Cela liste tous les joueurs connectés avec leurs identifiants.

Lequel utiliser :

• license : lié à la license Rockstar du joueur. Présent pour tout le monde, c'est donc le choix sûr.
• fivem : lié au compte Cfx.re. Stable, et bien pour le staff qui utilise plusieurs PCs.
• discord : lié au compte Discord, et seulement présent quand l'application Discord est ouverte sur le PC du joueur au moment où il se connecte. Ne vous y fiez pas seul.

Attention : copiez l'identifiant depuis la page du joueur dans txAdmin, pas depuis une capture d'écran que quelqu'un d'autre vous aurait envoyée. Un identifiant incorrect ou ancien donne l'accès administrateur à une autre personne ou à personne.

#Étape 4 : l'appliquer

server.cfg est lu au démarrage du serveur, donc redémarrez le serveur. Vous pouvez aussi coller les lignes dans la console du serveur pour les appliquer sans redémarrage :

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Reconnectez-vous au serveur après cela, car vos permissions sont vérifiées quand vous vous joignez.

Pour tester, exécutez une commande qui nécessite une permission, ou dans la console F8 utilisez une commande que vous savez être restreinte. Si vous pouvez l'utiliser, la règle fonctionne.

#Administrateur dans ESX

ACE contrôle les commandes. ESX possède aussi ses propres groupes de joueurs, stockés dans la colonne group de la table users dans votre base de données. Un joueur est user par défaut, et un administrateur est admin.

Depuis la console du serveur vous pouvez le définir avec :

setgroup 1 admin

où 1 est l'ID de votre serveur (voir la liste des joueurs dans txAdmin). Vous pouvez aussi éditer la colonne group directement avec un outil de base de données, puis vous reconnecter. Certains scripts administrateur lisent le groupe ACE, d'autres lisent le groupe ESX, donc définissez les deux si l'un d'eux ne fonctionne pas.

#Administrateur dans QBCore

QBCore lit ses permissions depuis ACE. Le server.cfg par défaut dans QBCore définit des groupes comme qbcore.god, qbcore.admin et qbcore.mod. Ajoutez-vous au groupe que vous voulez :

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd qbcore.god

Si vous ne voyez pas ces lignes de groupe dans votre server.cfg, vérifiez celui qui vient avec qb-core et copiez-les. Redémarrez et reconnectez-vous, puis essayez une commande administrateur.

Sur QBox, les permissions sont aussi basées sur ACE. Suivez l'exemple dans la documentation qbx_core ou son server.cfg par défaut, et utilisez la même forme add_principal avec votre identifiant.

#Si ça ne fonctionne toujours pas

• Aucun effet du tout : la ligne est dans un server.cfg que le serveur ne charge pas, ou elle est commentée. Vérifiez le chemin en haut de la console txAdmin.
• Une typo dans l'identifiant : comparez-le caractère par caractère avec la page du joueur dans txAdmin.
• Vous ne vous êtes pas reconnecté : les permissions sont appliquées quand vous vous joignez.
• Mauvais préfixe : c'est identifier.license: avec un point, pas identifier:license: ou license:.
• Le framework dit toujours non : définissez aussi le groupe ESX ou QBCore, comme ci-dessus.

Pour l'accès au panneau txAdmin lui-même, c'est une connexion séparée, voir txAdmin password perdu.

#Checklist