Le fossé entre outillage amateur et pro
La plupart des menus admin FiveM sont de niveau amateur: boutons pour filer des armes, téléporter, noclip, ce genre de choses. Agency-Admin est conçu pour les communautés qui prennent la modération aussi au sérieux qu'une équipe de modération d'un vrai studio de jeu.
Journalisation des actions avec contexte
Chaque action admin est écrite dans un journal inviolable avec l'ID admin, la cible, l'action, l'horodatage et la raison. Fini les mystères 'qui a donné un Rhino à ce joueur?'. Les journaux sont interrogeables depuis l'UI admin avec des filtres par admin, plage de temps et type d'action. C'est l'infrastructure de responsabilité de base dont les équipes staff ont vraiment besoin.
Niveaux de permissions
Trois niveaux intégrés: modérateur (kick, timeout, vérifications basiques d'items), admin (ban, donner des items, téléporter), admin senior (changements de config, gestion des permissions, admin de base de données). Les actions de chaque niveau sont strictement cadrées - un modérateur ne peut pas s'auto-escalader en trouvant une faille. On a testé ce modèle avec plusieurs grosses communautés ces deux dernières années.
Gestion des bans
Les bans supportent durée, raison, URL de preuve (capture ou lien vidéo), statut de l'appel et notes de révision. Quand un joueur banni essaie de se reconnecter, le message qu'il voit inclut la raison et - si configuré - un lien d'appel. Une modération transparente est une modération efficace.
Détection de menaces en temps réel
Agency-Admin livre une couche de détection configurable qui signale les patterns suspects: pics soudains d'argent, téléportations impossibles, duplication rapide d'items, spawns d'armes inhabituels. Les signalements remontent dans le dashboard admin avec tout le contexte. On n'est pas un anticheat - on est un outil de détection qui fait passer le temps de réaction admin d'heures à minutes.
Installation et configuration
Agency-Admin nécessite oxmysql pour la persistance des journaux. Importez admin.sql dans votre base de données, ajoutez la ressource au serveur et ajoutez ensure agency-admin à server.cfg. L'attribution initiale des admins se fait via config.lua — listez vos identifiants les plus fiables comme admins seniors.
Options de configuration
- Niveaux de permission — les noms et capacités de chaque niveau sont entièrement redéfinissables.
- Seuils de détection — configurez le seuil de pic d'argent, la limite de distance de téléportation et la vitesse de comptage d'articles qui déclenchent des signalements.
- Webhook Discord — toutes les actions admin et signalements de détection peuvent être transmis à un canal Discord.
- Rétention des journaux — combien de jours les journaux d'actions admin sont conservés. Défaut : 90 jours.
Compatibilité avec les frameworks
Agency-Admin fonctionne sur QBCore, ESX et les configurations autonomes. La couche de permission est le seul composant touchant le framework. Pour les configurations personnalisées, le shim de compatibilité est quatre fonctions dans config.lua.
Pourquoi c'est important pour le roleplay
La santé du serveur est directement liée à la qualité de la modération. Les communautés avec une modération visible, cohérente et responsable retiennent les joueurs plus longtemps. Le journal d'audit d'Agency-Admin est le mécanisme clé de responsabilité : quand une décision de modération est contestée, le journal fournit le contexte exact. La couche de détection change la posture de l'équipe admin de réactive à proactive.
Construire une culture d'équipe autour des outils
Les meilleurs outils admin du monde n'aident pas si votre culture d'équipe ne soutient pas la responsabilité. Établissez tôt que toutes les actions admin passent par l'interface enregistrée. Utilisez les signalements de détection dans les revues hebdomadaires du personnel. Le système de niveaux de permission fonctionne mieux quand les promotions à travers les niveaux sont des jalons significatifs.
Foire aux questions
Puis-je ajouter des commandes admin personnalisées ?
Oui. Utilisez exports['agency-admin']:RegisterCommand(name, tier, handler) pour enregistrer des commandes personnalisées qui héritent des vérifications de permission d'Agency-Admin.
Comment le système de bannissement gère-t-il les VPN et alt-accounts ?
Agency-Admin enregistre l'ensemble d'identifiants complet (licence, Steam, Discord, IP) au moment du bannissement. Lors des tentatives de reconnexion, tous les identifiants sont vérifiés.
Prérequis
- Serveur FiveM (QBCore, ESX ou autonome)
- oxmysql
- Compte cfx.re avec licence Agency-Admin valide
Flux de travail de modération dans la pratique
Gérer un serveur FiveM actif signifie traiter des dizaines d'incidents chaque jour. Sans bons outils, les administrateurs passent plus de temps à naviguer dans des menus qu'à résoudre réellement les problèmes. Agency-Admin rationalise ce flux de travail avec une interface conçue pour la vitesse.
Un scénario typique de modération ressemble à ceci :
- Un rapport arrive via Agency-Reports ou le chat
- L'admin ouvre Agency-Admin et localise le joueur signalé en quelques secondes
- L'admin peut observer le joueur en spectateur sans que ce dernier le sache
- Si nécessaire, l'admin peut intervenir — avertissement, gel, ou bannissement avec logs automatiques
- Tout est enregistré dans la base de données pour référence future
Système de permissions granulaires
Tous les admins ne devraient pas avoir les mêmes pouvoirs. Agency-Admin supporte les hiérarchies d'administration — les modérateurs junior peuvent gérer les rapports basiques tandis que les admins senior ont accès aux outils plus puissants. Cela protège votre serveur contre les abus potentiels de permissions.
Logs et historique
Chaque action d'administration est loggée avec un timestamp, l'identifiant Steam du joueur affecté, la raison fournie et l'admin responsable. Ces logs sont précieux lors des appels de bannissement — vous avez un historique complet et consultable de chaque décision.
Support multi-serveur
Si vous gérez plusieurs instances de serveur FiveM, Agency-Admin peut être configuré pour partager les données de bannissement entre serveurs. Un joueur banni sur un serveur peut être automatiquement bloqué sur tous vos serveurs, protégeant toute votre communauté simultanément.
À propos d'Agency Scripts
Agency Scripts est une collection de ressources FiveM premium conçues pour les serveurs de roleplay qui prennent l'immersion au sérieux. Chaque ressource est construite avec les mêmes principes : compatibilité multi-framework, performances optimisées, et configuration flexible pour s'adapter à n'importe quel concept de serveur.
Toutes les ressources Agency sont disponibles via le système de licences cfx.re Keymaster. Une fois achetée, vous pouvez déployer la ressource sur n'importe quel serveur que vous possédez, avec un support actif disponible via le Discord Agency Scripts.
Support et communauté
La communauté Agency Scripts comprend des milliers de serveurs FiveM qui utilisent ces ressources. Le Discord officiel est l'endroit où les développeurs partagent leurs configurations, posent des questions, et suggèrent de nouvelles fonctionnalités. Les mises à jour sont régulières et incluent à la fois des corrections de bugs et de nouvelles fonctionnalités basées sur les retours de la communauté.
Pour les questions d'installation, les problèmes de compatibilité ou les demandes de fonctionnalités, le Discord reste le meilleur canal. La documentation est maintenue à jour et couvre tous les paramètres de configuration avec des exemples pratiques.