Modifier server.cfg et les permissions depuis Agora

L'éditeur de fichiers .cfg masque les secrets, vérifie avant d'enregistrer et sauvegarde l'ancienne version ; le configurateur de permissions gère les groupes ACE sans toucher au reste du fichier.

Mis à jour le 5 oct. 2026, 09 h 25

Sur cette page

Modifier un fichier
Les secrets restent masqués
Sauvegarde et restauration
Appliquer le changement
Les permissions (ACE)

En bref. Serveur → Éditeur .cfg ouvre server.cfg et tous les fichiers qu'il inclut par exec, directement depuis Agora. C'est réservé aux administrateurs (avec la 2FA du staff) et aux licences Pro. Il faut un panel d'hébergement relié (Pterodactyl ou Pelican) : l'éditeur lit et écrit les fichiers par l'API du panel.

Modifier un fichier #

Ouvre Serveur → Éditeur .cfg. Chaque fichier inclus a son onglet ; un exec vers un fichier absent est marqué « absent » : l'enregistrer le crée.
Modifie le texte.
Clique sur Vérifier et enregistrer… : tu vois les lignes ajoutées et retirées, et les vérifications du fichier.
Clique sur Confirmer l'enregistrement.

Ce qui est vérifié : guillemet non fermé, ensure d'une ressource qui n'existe pas dans resources/, ensure en double, ordre de démarrage (oxmysql et ox_lib avant le framework, la ressource agora après le framework), port d'endpoint que le panel n'a pas alloué, ports TCP et UDP différents, sv_licenseKey absente. Seules les erreurs graves (fichier de plus de 512 Ko, octet nul, marqueur de secret abîmé) bloquent ; le reste avertit.

Seuls les .cfg du dossier du serveur se modifient ici.

Les secrets restent masqués #

La clé de licence, les clés d'API, la chaîne MySQL, le mot de passe RCON, les webhooks et les jetons apparaissent sous la forme {{secret:NOM}}. Laisse le marqueur tel quel pour garder la valeur, ou remplace-le par la nouvelle valeur. Le bouton Afficher montre un secret ; le geste est noté dans le journal d'administration.

Sauvegarde et restauration #

Avant chaque enregistrement, l'ancienne version est copiée dans .agora-backup/ (les 20 dernières par fichier). La liste Sauvegardes propose Restaurer ; le fichier actuel est lui-même sauvegardé avant. Si le fichier a changé sur le serveur pendant que tu l'éditais (panel, txAdmin, autre onglet), Agora le détecte : Recharger (perd mes modifications) repart de la version du serveur, Écraser quand même garde la tienne. Enregistrer et restaurer sont plafonnés à 20 par minute et par administrateur ; au-delà, un message demande d'attendre une minute.

Appliquer le changement #

server.cfg et les convars : redémarre le serveur (sous txAdmin, redémarre depuis txAdmin, qui lit le même fichier).
Un autre fichier .cfg : Recharger à chaud (exec …) l'exécute sans redémarrer, au prochain battement du serveur (environ 30 secondes, ressource agora en ligne). Attention : un droit retiré n'est pas révoqué par exec, et un fichier qui contient des ensure redémarre ces ressources.

Les permissions (ACE) #

Passe au mode Permissions (ACE). Agora lit le fichier de permissions (permissions.cfg s'il est inclus) et propose quatre vues :

Vue	À quoi elle sert
Groupes	Les droits (`add_ace`) de chaque groupe et ses héritages (`add_principal`) ; créer, renommer, supprimer un rôle
Personnes	Qui est dans quel groupe ; tu choisis un membre relié ou tu saisis un identifiant à la main (`license:`, `discord:`, `steam:`…)
Modèles	Les lignes officielles du framework détecté (Qbox, QBCore, ESX ou FiveM sans framework) : seules les lignes manquantes sont ajoutées
Non gérées	Les lignes que le configurateur ne sait pas modifier, conservées telles quelles

Seules les lignes que tu changes sont réécrites : commentaires et ordre restent. Une personne ajoutée porte un commentaire # Agora: pseudo au-dessus de sa ligne. Un ajout se prend en compte avec exec permissions.cfg dans la console ; un retrait demande un redémarrage.

txAdmin n'utilise pas les ACE pour ses propres administrateurs : ils se gèrent dans son Admin Manager. Aucun modèle d'Agora n'y touche.

Cet article t'a aidé ?