Frameworks pris en charge : ESX, QBCore, Qbox

Framework Automatique ou fixe, ce qu'Agora lit dans chaque framework, comment un joueur est reconnu, et l'ordre de démarrage à respecter dans server.cfg.

Mis à jour le 27 sept. 2026, 12 h 03

Sur cette page

Automatique ou fixe
Ce qu'Agora lit
Comment un joueur est reconnu
L'ordre dans server.cfg
OneSync
Un serveur sans framework

En bref. Agora fonctionne avec ESX, QBCore et Qbox. Le framework se règle dans Serveur → Base de données : Automatique par défaut, ou fixé à la main. La ressource agora doit démarrer après le framework, et OneSync doit être actif.

Automatique ou fixe #

Automatique est le choix par défaut d'une nouvelle installation. Agora retrouve alors le framework en croisant deux sources :

ce que la ressource en jeu annonce à son démarrage (elle regarde si qbx_core, qb-core ou es_extended tourne) ;
les tables de ta base : users.identifier pour ESX, players.citizenid pour QBCore et Qbox. Qbox se reconnaît à player_groups, ou à la jointure players.userId → users.userId.

Sous le menu Framework, l'écran dit ce qui est détecté maintenant et d'où ça vient : « Détecté : QBox (annoncé par la ressource en jeu) » ou « … (d'après les tables de la base) ». Le bouton Tester le redit. La détection est refaite quand tu enregistres ou testes la connexion, quand la ressource annonce un autre framework, et sinon au plus toutes les 10 minutes : Agora n'interroge jamais ta base en boucle.

Quand la détection ne peut pas trancher, Agora ne devine pas. L'écran affiche « Non détecté : … » avec la raison, le MDT, la carte live et le portail ne lisent aucun personnage (le forum n'est pas touché), et l'échec arrive dans Administration → Erreurs.

Raison affichée	Ce qui se passe	Que faire
« …ni les tables ESX ni celles de QBCore/QBox… »	Mauvaise base, ou tables du framework pas encore importées	Vérifie le nom de la base, importe le SQL du framework
« …à la fois les tables d'ESX et celles de QBCore… »	La base garde les tables de deux frameworks et la ressource n'a encore rien annoncé	Démarre le serveur de jeu avec la ressource (son annonce tranche), ou fixe le framework
« …la ressource en jeu annonce QBox, mais la base ne contient que les tables du framework ESX… »	La connexion pointe sur la base d'un autre serveur	Corrige la base, ou fixe le framework
« …la base du serveur de jeu ne répond pas… »	Base injoignable, et la ressource n'a encore rien annoncé	Voir Base du jeu injoignable

Fixer le framework (ESX, QBCore ou QBox) coupe toute détection : Agora lit ce framework-là, point. Une installation qui avait déjà enregistré un framework le garde après la mise à jour ; rien ne change tant qu'un administrateur ne repasse pas le menu sur Automatique et n'enregistre pas. La ressource en jeu suit le même réglage.

Ce qu'Agora lit #

Framework	Personnages	Jobs et grades	Véhicules	Permis
ESX	`users`	tables `jobs` et `job_grades`	`owned_vehicles`	table `user_licenses`
QBCore	`players`	déduits des personnages, table `jobs` si elle existe, ou `jobs.lua`	`player_vehicles`	`metadata` du personnage
Qbox	`players` et `users`	`players`, `player_groups`, ou `jobs.lua`	`player_vehicles`	`metadata` du personnage

Les multi-jobs (player_groups) sont pris en compte. Agora s'adapte aux bases qui n'ont pas toutes les colonnes.

En QBCore et Qbox, les jobs sont déclarés en Lua : sans panel ni SFTP, seuls les jobs déjà portés par un personnage apparaissent. Relie le panel ou le SFTP pour lire jobs.lua et avoir la liste complète.

Comment un joueur est reconnu #

Par sa licence FiveM (license: ou license2:), que Cfx garantit, une fois qu'il a relié son jeu par un code. L'identifiant discord: que le client FiveM annonce ne suffit pas : personne ne le vérifie.

ESX : identifier (avec ou sans char1:, avec ou sans license:).
QBCore et Qbox : players.license.

Le joueur doit tout de même avoir Discord lié à FiveM : sans identifiant Discord, la tablette ne s'ouvre pas.

L'ordre dans server.cfg #

ensure qbx_core     # ou qb-core, ou es_extended
ensure agora

En Automatique, la ressource détecte le framework au démarrage : il doit donc déjà tourner quand ensure agora passe. Si aucun ne tourne, la console affiche « framework : aucun framework détecté ».

Si le framework fixé ne tourne pas, la console l'annonce au démarrage : « framework : qbox configuré mais qbx_core introuvable — la carte live et le MDT n'auront pas de personnages ». Démarre le framework avant ensure agora, ou repasse le menu sur Automatique (ou choisis le bon) dans Serveur → Base de données.

OneSync #

ESX Legacy, QBCore récent et Qbox exigent déjà OneSync. Avec lui, c'est le serveur qui lit les positions pour la carte live. Sans lui, la console l'annonce en jaune et les clients envoient leur position eux-mêmes, seulement pendant qu'une carte est ouverte. Active-le (onesync on) pour que les clients n'envoient plus rien.

Un serveur sans framework #

La ressource fonctionne quand même : la carte live montre les joueurs par leur nom FiveM, en gris. Le MDT n'a pas de personnages à lire. Laisse le framework sur Automatique : l'alerte « … configuré mais … introuvable » ne revient plus à chaque démarrage, la console note seulement « aucun framework détecté ».

Cet article t'a aidé ?