Dépanner la ressource FiveM
Aucun signal, secret refusé, OneSync absent, tablette blanche, framework introuvable : les messages de la console et leur solution.
Mis à jour le 5 oct. 2026, 13 h 36
Sur cette page
En bref. Commence toujours par deux endroits : la console du serveur de jeu (les lignes [agora]) et Serveur → Joueurs dans Agora (le dernier signal reçu). Active ensuite Journal détaillé (débogage) dans Administration → Configuration → Ressource Agora : il s'applique à chaud.
Aucun signal reçu #
Serveur → Joueurs affiche « Aucun signal reçu : la ressource agora n'est pas encore déployée ou ne joint pas Agora ». Vérifie dans l'ordre :
- La ressource est démarrée :
ensure agoradansserver.cfg, après le framework, puisrefreshetensure agora. - Le serveur de jeu joint le site : depuis la machine du serveur de jeu, ouvre
ADRESSE-DU-SITE/api/health. - L'adresse embarquée est la bonne : Administration → Configuration → Ressource Agora affiche « Adresse embarquée dans la ressource ». Si elle est fausse, corrige-la dans Administration → Configuration → Identité du site et redéploie. Quand l'adresse de la ressource déployée diffère de celle du site, un bandeau le dit aussi : « La ressource pointe vers … Redéploie-la pour qu'elle suive », avec un bouton Redéployer.
Secret refusé #
Console : [agora] présence : Agora a répondu 401 (URL ou secret à vérifier). Ou la tablette s'ouvre sur l'écran de connexion.
Cause : le secret de config.server.lua ne correspond plus à celui du site (secret régénéré depuis le déploiement). Correction : retélécharge ou redéploie la ressource.
Si la ligne dit plutôt Agora a répondu 0 (ou 502…) « site injoignable ou en redémarrage — nouvel essai automatique », ni l'adresse ni le secret ne sont en cause : le site redémarre ou est coupé (mise à jour, panne). La ressource réessaie seule ; vérifie ADRESSE-DU-SITE/api/health si ça dure.
« Agora a répondu 301 » (ou 302) : une redirection #
Console : [agora] présence : Agora a répondu 301 (URL ou secret à vérifier). Depuis la ressource 0.3.2, la ressource ne suit plus aucune redirection : si l'adresse d'Agora répond par un 301 ou un 302, la réponse est traitée comme une erreur ordinaire. Sinon, le secret partagé aurait été renvoyé tel quel à la nouvelle adresse, peut-être un autre hôte, peut-être du http. Le site d'Agora, lui, ne redirige jamais ses routes /api/ingame : le problème vient de l'adresse ou d'un reverse proxy placé devant.
Correction : mets l'adresse finale (celle qui répond sans redirection, en https) dans Administration → Configuration → Identité du site, puis retélécharge ou redéploie la ressource. Voir aussi Derrière un proxy. L'option est prise en charge par les builds de FXServer récentes ; une build très ancienne l'ignore simplement.
« REFUS : … n'est ni en https ni sur ton réseau local » #
La ressource refuse d'envoyer le secret en clair sur Internet. Passe le site en https, ou donne l'adresse privée du site si le serveur de jeu est sur le même réseau. Voir config.lua et le secret.
OneSync absent #
Console, en jaune : « carte live : OneSync désactivé — repli : les CLIENTS envoient leur position… ». Tout fonctionne, mais les clients travaillent pour la carte. Active OneSync (onesync on, activé par défaut sur les artefacts récents).
La tablette s'ouvre sur une page blanche #
| Cause | Correction |
|---|---|
Le dossier de la ressource ne s'appelle pas agora (la console le signale au démarrage) | Renomme-le agora et redémarre la ressource |
Site en http:// sans HTTPS : certains navigateurs refusent les cookies de la tablette | Passe le site en HTTPS |
| Le site ne répond pas | Vérifie ADRESSE-DU-SITE/api/health |
| Tu as coché Tablette : limiter les pages et interdire de remplacer la tablette (CSP + bac à sable) et la tablette ne s'affiche plus, ou une page de paiement refuse de s'ouvrir (passerelle autre que PayPal / Tebex) | Décoche le réglage dans Administration → Configuration → Ressource Agora, enregistre et redéploie la ressource : voir Les réglages lus depuis le site |
Messages vus par les joueurs #
| Message | Correction |
|---|---|
| « Aucun compte Discord lié à ton FiveM. » | Le joueur lie Discord à FiveM (application Discord ouverte), puis relance le jeu |
| « Charge un personnage avant d'ouvrir Agora. » | Choisir un personnage d'abord |
| Écran « Relie ton compte » | Le joueur relie son jeu une fois : voir Relier son jeu |
| « Ressource mal générée (secret absent). » | Retélécharge la ressource depuis le site |
Commande déjà prise #
Console, en jaune : « la commande /911 est déjà utilisée par la ressource « … » : Agora ne l'écrase pas ». Un autre script de dispatch a pris la commande. Change le nom de la Commande d'appel dans Administration → Configuration → Ressource Agora (effet au prochain redémarrage de la ressource), ou garde l'autre script.
Framework introuvable #
| Message de la console | Cause | Correction |
|---|---|---|
| « framework : qbox configuré mais qbx_core introuvable » (ou « non démarré ») | Le framework fixé dans Serveur → Base de données ne tourne pas sur le serveur | Démarre le framework avant ensure agora, ou repasse le menu sur Automatique (ou choisis le bon). Sur un serveur sans framework, laisse Automatique : l'alerte ne revient plus |
| « framework : aucun framework détecté » | Mode Automatique (le défaut), et ni qbx_core, ni qb-core, ni es_extended n'est démarré | Normal sur un serveur sans framework : la carte live montre les joueurs par leur nom FiveM. Si ton serveur en a un, vérifie qu'il démarre avant ensure agora |
Côté site, Serveur → Base de données dit sous le menu Framework ce qu'Agora a détecté, ou pourquoi rien ne l'est : voir Frameworks pris en charge.
Erreurs Lua #
Les erreurs de la ressource (depuis la 1.9.9, donc aussi dans la 0.3.3 actuelle) arrivent aussi dans Administration → Erreurs, source Ressource FiveM. Après une mise à jour d'Agora, redéploie la ressource : une ressource trop ancienne n'envoie pas tout.
Avant d'ouvrir un billet #
Note la version (Serveur → Joueurs), active le journal détaillé, et copie les lignes [agora] de la console. Ne transmets jamais config.server.lua.
Cet article t'a aidé ?
Articles liés
- Installer la ressource FiveM agoraTrois façons de déposer la ressource : un clic par le panel, par SFTP, ou le zip posé à la main ; toujours sous le nom agora, après le framework.
- config.lua (l'adresse) et config.server.lua (le secret)La ressource ne garde que deux choses dans ses fichiers : l'adresse du site et le secret partagé ; tout le reste se règle sur le site.
- Frameworks pris en charge : ESX, QBCore, QboxFramework 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.
- Les erreurs et les rapports d'erreurs (Administration → Erreurs)Agora range chaque panne du site, des navigateurs et de la ressource FiveM, nettoyée de toute donnée sensible, et peut l'envoyer à l'équipe d'Agora.
- Relier son jeu à son compte (une seule fois)Un code obtenu sur le site, saisi dans la tablette : ensuite, la tablette te reconnaît seule et tes personnages apparaissent sur le site.
- Les réglages de la ressource lus depuis le siteCommande, touche, 911, cadence, animation, débogage, habillage, framework, carte et langue : la ressource les lit au démarrage et applique tes changements à chaud.
- Derrière un proxy : HTTPS, Cloudflare et adresse IP des visiteursObtenir le HTTPS pour ton Hub (Caddy, Cloudflare, proxy de ton hébergeur, Nginx), puis régler AGORA_TRUSTED_PROXIES et laisser passer les flux en direct.