Agency Docs
Standalone

Agency-Admin Panneau web

Panel admin pour FiveM au design Agency avec un web panel complet sur ton PC.

v1.10.0Payant7 Pages

1 Le panneau web dans Agency Companion

Agency-Admin propose un panneau d'administration complet pour ton PC : companion.agencyg.de/app/admin. Il fonctionne dans Agency Companion, dans ton navigateur, et joint ton serveur par le relais Agency chiffré, comme l'application mobile. Tu n'as aucun port à ouvrir et rien n'est hébergé sur ton serveur de jeu.

PageCe que tu peux faire
Tableau de bordJoueurs en ligne, temps de tick, durée de fonctionnement, resources, argent en ville, dernières actions
JoueursToutes les actions d'admin du panneau en jeu, messages et avertissements, vue en direct de l'écran d'un joueur
Console en directLa console complète du serveur et les commandes exécutées comme console du serveur
ResourcesDémarrer, arrêter et redémarrer n'importe quelle resource, relire la liste des resources
ConfigsLes fichiers de config de chaque resource de ton serveur, modifiés sous forme de paramètres ou de code
FichiersGestionnaire de fichiers avec éditeur pour tes resources
Bans, journal des actions, équipe & rangs, contrôle du serveurBans hors ligne, l'historique de chaque action d'admin, redémarrer ou arrêter le serveur avec un compte à rebours

Le panneau web est conçu pour un PC. Sur un téléphone ou une tablette, utilise l'application Agency Companion, le module d'administration y est intégré.

2 Connexion

En jeu, ouvre le menu admin, va sur Panneau web et clique sur Ouvrir dans le navigateur, ou tape /webpanel. Le navigateur ouvre le panneau et te connecte tout de suite.

Sur un autre PC, ouvre companion.agencyg.de/app/admin et saisis le code à 6 chiffres affiché sur la page Panneau web. Un code est valable 5 minutes.

Tu peux connecter autant de serveurs que tu en gères et passer de l'un à l'autre dans le panneau. Chaque connexion est un appareil associé, que tu peux déconnecter en jeu sous Paramètres > Companion.

3 Permissions et sécurité

Le navigateur détient un jeton d'appareil, comme l'application. Chaque clic est vérifié en direct sur ton serveur par rapport au rang et aux permissions de l'admin, avec la même limite de débit et le même journal des actions qu'en jeu.

PermissionDébloqueHéritée
companion_consoleConsole en direct et resourcesoui
server_powerRedémarrer et arrêter le serveurnon, uniquement le rang le plus élevé et les rangs que tu coches
web_filesFichiers et Configsnon, uniquement le rang le plus élevé et les rangs que tu coches

Sans être en jeu. Comme txAdmin, le panneau web fonctionne aussi quand tu n'es pas sur le serveur. Agency-Admin mémorise les permissions de chaque admin depuis sa dernière présence en jeu, y compris lorsqu'elles viennent d'ACE ou du framework (permissions QBCore, groupes ESX), et les tient à jour pendant qu'il joue. Un admin qui reste trois minutes sur le serveur sans accès au panneau perd les permissions mémorisées. Les permissions que tu définis pour un joueur dans le panneau et les attributions de rang sont toujours prioritaires.

La console, la relecture des resources et le redémarrage du serveur s'exécutent comme des commandes de console. Ils nécessitent une ligne dans server.cfg :

add_ace resource.Agency-Admin command allow

4 Les configs de chaque resource

La page Configs liste les fichiers de config de chaque resource de ton serveur, quel qu'en soit l'auteur, trouvés automatiquement : config.lua, shared/config.lua, config/*.lua, settings.lua, config.json et chaque fichier de config cité par le fxmanifest.lua d'une resource. Aucune resource n'a besoin de s'enregistrer.

VueCe qu'elle affiche
ParamètresChaque valeur simple (true ou false, nombres, textes) sous forme d'interrupteur ou de champ, avec le commentaire du fichier à côté, regroupée par section. Modifier une valeur ne change que cette ligne, la mise en forme et les commentaires restent.
CodeLe fichier entier avec coloration syntaxique.

Enregistrer vérifie d'abord la syntaxe sur le serveur, de sorte qu'un config.lua cassé n'est jamais écrit. L'ancienne version est conservée avant chaque enregistrement (les 15 dernières par fichier, dans Agency-Admin/config_backups). Enregistrer et redémarrer redémarre la resource immédiatement, Versions précédentes restaure une ancienne version.

Les configs chiffrées avec FiveM Escrow sont affichées avec un cadenas et ne peuvent pas être modifiées.

5 Builds FXServer récents : une ligne par resource

Les builds FXServer à partir d'environ 25770 placent le système de fichiers en bac à sable : une resource ne peut écrire dans une autre resource que si server.cfg l'autorise avant le démarrage du serveur. Un serveur en cours d'exécution ignore ces lignes. Ajoute une ligne pour chaque resource dont tu veux enregistrer la config depuis le panneau, puis redémarre le serveur une fois :

add_filesystem_permission Agency-Admin write qb-core
add_filesystem_permission Agency-Admin write Agency-Housing

Quand une ligne manque, le panneau te le dit à l'enregistrement et affiche les lignes exactes à copier, pour cette resource ou pour toutes les resources ayant une config en une seule fois. Dans txAdmin, tu les colles dans le CFG Editor.

6 Fichiers

La page Fichiers ouvre chaque resource de ton serveur avec un gestionnaire de fichiers et un éditeur : parcourir, ouvrir, modifier, enregistrer, créer, renommer et supprimer des fichiers et des dossiers, avec la même ligne par resource que dans la section 5 pour enregistrer dans d'autres resources.

Les builds FXServer récents ne laissent aucune resource lire le dossier du serveur, server.cfg ou les dossiers de catégorie comme [standalone]. Au-dessus des resources, le panneau affiche donc les dossiers reconstruits à partir de tes resources installées, en lecture seule, avec une note. À l'intérieur d'une resource, tu travailles comme d'habitude. server.cfg se modifie dans txAdmin, dans le CFG Editor.

Les fichiers plus grands que Config.WebPanelFiles.MaxEditKb (1024 Ko par défaut) ne sont pas ouverts dans l'éditeur. Config.WebPanelFiles.ReadOnly = true transforme le gestionnaire de fichiers en simple visionneuse.

Toujours bloqué après cette page ? Notre support prend le relais.