Mettre à jour la ressource FiveM
Après une mise à jour d'Agora, un changement d'adresse ou de secret, redéploie la ressource ; les autres réglages s'appliquent sans la toucher.
Mis à jour le 5 oct. 2026, 13 h 36
En bref. La plupart des réglages de la ressource vivent sur le site et s'appliquent seuls. Il faut redéployer la ressource dans trois cas seulement : une nouvelle version, une nouvelle adresse du site, un nouveau secret.
Quand redéployer #
| Situation | Redéployer ? |
|---|---|
| Agora a été mis à jour et la version de la ressource a changé | Oui |
| L'adresse publique du site a changé | Oui (elle est dans config.lua) |
| Le secret partagé a été régénéré | Oui (il est dans config.server.lua) |
| Tu as coché « Autoriser le http en clair », changé le réglage CSP stricte de la tablette ou importé un cadre de tablette personnalisé | Oui |
| Commande, touche, commande d'appel, événements d'habillage | Non, mais redémarre la ressource (bouton Redémarrer la ressource) : elle les lit au démarrage |
| 911, cadence, animation, carte, débogage… | Non : la ressource les lit sur le site et les applique à chaud |
Après chaque Enregistrer sur la page, le site te dit le bon geste : « redéploie-la, puis redémarre-la », « redémarre-la », ou « Appliqué à chaud : rien d'autre à faire ».
Savoir si elle est à jour #
- Serveur → Joueurs, encadré Serveur de jeu : la version annoncée par la ressource.
- Administration → Configuration → Carte live, État du flux de positions : si la ressource est plus ancienne que celle fournie par Agora, un message te demande de la redéployer.
- Dans la console du serveur de jeu, au démarrage :
[agora] v0.3.3 — ….
La version 0.3.3 reprend les changements de la 0.3.2 (les appels de la ressource vers Agora ne suivent plus aucune redirection, pour que le secret partagé ne parte jamais vers une autre adresse ; un réglage CSP stricte de la tablette, désactivé par défaut : voir Dépanner la ressource et Les réglages lus depuis le site) et rend la ressource plus solide :
- une erreur ne la fige plus : si le traitement d'une réponse d'Agora échoue, la ressource ne reste plus bloquée en « envoi en cours » (le site voyait alors le serveur hors ligne jusqu'au prochain redémarrage) : l'erreur est rapportée et l'envoi reprend, et un envoi sans réponse depuis 30 secondes est repris ;
- le framework a le dernier mot : l'état annoncé par un événement du framework (personnage, job, grade) n'est qu'un indice ; s'il diffère de ce que le framework connaît, c'est le framework qui fait foi. Un événement mal ordonné ou forgé par une ressource tierce ne fixe donc plus un faux état ;
- changer de personnage remet à zéro les alertes d'appel de l'ancien personnage et le délai du portrait ;
- une photo de dossier dont la cible quitte le serveur libère l'agent, qui en est prévenu (« La cible a quitté le serveur. ») ;
- la cadence de présence est plafonnée à 60 secondes (voir Les réglages lus depuis le site) ;
- l'ouverture de la tablette est limitée par joueur (10 par minute), pour que quelques clients modifiés ne puissent plus empêcher tous les autres de l'ouvrir.
Redéploie-la après la mise à jour d'Agora pour en profiter.
La numérotation de la ressource est repartie de zéro : toute ressource qui annonce une 1.x (1.0.0 à 1.10.x) est plus ancienne que la 0.3.3, et Agora te propose de la redéployer.
Redéployer #
Même procédure que l'installation, au choix :
- Déployer via le panel (Administration → Configuration → Ressource Agora, bloc Installation, ou Serveur → Panel), ou Redéployer dans le bandeau « La ressource pointe vers … » : fichiers remplacés et ressource relancée (sous txAdmin, relance-la par txAdmin) ;
- Déployer par SFTP, puis
refreshetensure agoradans la console du serveur ; - Télécharger agora.zip (Administration → Configuration → Ressource Agora), puis remplace le dossier
resources/agoraen entier, etrefresh+ensure agora.
Pas besoin de toucher à server.cfg : la ligne ensure agora y est déjà.
Après un redéploiement #
Vérifie dans Serveur → Joueurs que le dernier signal est récent et que la version affichée est la bonne.
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.
- 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.
- Mettre à jour Agora en un clic (et le canal bêta)Administration → Agora sauvegarde la base, télécharge et vérifie la nouvelle version, migre, redémarre, et revient en arrière tout seul si elle ne démarre pas.
- 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.