Les réglages de la ressource lus depuis le site
Commande, touche, 911, cadence, animation, débogage, habillage, framework, carte et langue : la ressource les lit au démarrage et applique tes changements à chaud.
Mis à jour le 5 oct. 2026, 13 h 36
Sur cette page
En bref. La ressource fait un seul appel au site au démarrage pour lire ses réglages, puis reçoit tes changements à chaud par le canal de présence qui tourne déjà (aucune requête en plus). Tu règles tout dans Administration → Configuration → Ressource Agora.
Ouverture en jeu #
| Réglage | Effet | Défaut |
|---|---|---|
| Commande en jeu | Les joueurs tapent /commande (lettres, chiffres et _) | agora |
| Touche d'ouverture | Nom de touche FiveM ; vide = commande seulement | F2 |
Ces réglages sont dans le bloc Configuration de la ressource, enregistrés d'un seul coup. Le secret partagé (qui authentifie le serveur de jeu, généré à la demande), l'autorisation du http en clair et les événements d'habillage sont repliés sous Configuration avancée. Le code de la ressource est toujours livré lisible et commenté : il n'y a plus d'option « Protéger le code ».
Une nouvelle commande ou touche s'enregistre au prochain redémarrage de la ressource. La touche n'est qu'un défaut : un joueur qui l'a déjà changée dans Paramètres → Touches → FiveM garde la sienne.
Comportement en jeu #
| Réglage | Quand il s'applique | Défaut |
|---|---|---|
| Dispatch / appels 911 en jeu | À chaud | désactivé |
| Commande d'appel | Au prochain redémarrage de la ressource | 911 |
| Cadence de présence (secondes) | À chaud (10 à 60) | 30 |
| Animation d'ouverture | À chaud | activée |
| Journal détaillé (débogage) | À chaud | désactivé |
| Événements d'habillage | Au prochain redémarrage de la ressource | liste par défaut |
La cadence de présence est le rythme auquel la ressource annonce les joueurs à Agora. Elle est plafonnée à 60 secondes : Agora considère le serveur hors ligne après 90 secondes sans signal, et une cadence plus lente le ferait passer pour en panne (statut « injoignable », joueurs écartés du dispatch, vacations coupées). Une valeur plus haute enregistrée avant ce plafond est ramenée à 60 à la lecture, et l'écran refuse une nouvelle saisie au-delà de 60.
Les événements d'habillage sont les événements client de ton script de tenue après lesquels le portrait est renvoyé. Vide = la liste par défaut (skinchanger d'ESX, qb-clothing, illenium/fivem-appearance). Un par ligne, sous Configuration avancée. Sous la liste, l'écran dit ce qu'Agora a détecté (« Habillage détecté : … ») : si ton script d'habillage est reconnu, il n'y a rien à régler.
CSP stricte de la tablette #
Réglage Tablette : limiter les pages et interdire de remplacer la tablette (CSP + bac à sable), sous Configuration avancée, désactivé par défaut. Coché, il ajoute une protection à la tablette en jeu :
- le cadre du site ne peut plus naviguer la page de la tablette elle-même (bac à sable de l'iframe sans
allow-top-navigation) ; - il ne peut aller que vers ton site, Discord, PayPal et Tebex (CSP
frame-src) ; - les liens externes s'ouvrent dans une fenêtre à part.
Ce réglage est écrit dans les fichiers de la ressource : après Enregistrer, redéploie puis redémarre. Essaie-le d'abord : coche, enregistre, ouvre l'Aperçu in-game (tablette) (il applique le même réglage), puis vérifie la tablette en jeu après le redéploiement. Si elle ne s'affiche plus, ou si une page de paiement refuse de s'ouvrir (une passerelle autre que PayPal ou Tebex), décoche et redéploie : la tablette redevient exactement comme avant.
Droits dans la tablette #
Il n'y a plus de réglage « Droits d'admin dans la tablette » : la tablette s'ouvre toujours en vue joueur, avec les droits du joueur. L'administration, la console, la modération, la licence et les mises à jour restent fermées depuis le jeu : elles se font sur le site, dans ton navigateur.
Réglages lus ailleurs #
| Réglage | Où |
|---|---|
| Framework | Serveur → Base de données |
| Carte live (activée, cadence) | Administration → Configuration → Carte live |
| Langue | Administration → Configuration → Identité du site |
Quand un réglage prend effet #
Au prochain cycle de présence (30 secondes par défaut), sinon au prochain démarrage de la ressource. Après Enregistrer, le message te dit le geste à faire : « Appliqué à chaud : rien d'autre à faire », « redémarre-la » ou « redéploie-la, puis redémarre-la ».
Si le site est injoignable au démarrage #
La ressource part sur des défauts sûrs (dispatch désactivé, carte active), le dit en jaune dans la console, et réessaie.
Ce qui demande un redéploiement #
L'adresse du site, le secret, « Autoriser le http en clair », la CSP stricte de la tablette et le cadre de la tablette sont dans les fichiers : voir Mettre à jour la ressource.
Cet article t'a aidé ?
Articles liés
- 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.
- La tablette en jeu : touche, commande et droitsLa tablette s'ouvre par une commande et une touche que tu choisis, avec le personnage chargé ; les gestes d'administration restent sur le site.
- Le dispatch et les appels 911La file des appels et les unités en service en direct ; le 911 en jeu est désactivé par défaut et s'active dans Administration → Configuration → Ressource Agora.
- 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.