Installer la ressource FiveM agora

En bref. La ressource agora ouvre la tablette en jeu, envoie la présence des joueurs (qui joue quel personnage, en service ou non) et prend les photos. Elle est générée par ton site : l'adresse et le secret sont déjà dedans.

Avant de commencer #

• Ton site a une adresse publique enregistrée (Administration → Configuration → Identité du site). Sans elle, la ressource refuse de se générer : le téléchargement répond « Adresse du Hub inconnue : la ressource ne saurait pas où écrire… » au lieu de donner le zip.
• Le site est en https, ou joignable par une adresse de ton réseau local. Voir config.lua et le secret.
• OneSync est actif sur ton serveur (ESX Legacy, QBCore récent et Qbox l'exigent déjà).

Méthode 1 — Par le panel (recommandé) #

Il faut le panel relié dans Serveur → Panel et Détecter la configuration passé une fois (voir Console, panel et base).

1. Administration → Configuration → Ressource Agora, bloc Installation, carte Déployer via le panel (marquée Recommandé). Le même bouton existe dans Serveur → Panel, bloc Déploiement automatique.
2. Clique sur Déployer via le panel.

Agora envoie les fichiers dans resources/agora, ajoute ensure agora (et ses droits de relance) à server.cfg, puis relance la ressource par la voie qui atteint le serveur de jeu, avec refresh puis ensure agora :

• serveur en ligne : la ressource se relance d'elle-même à sa prochaine présence, ou par la console du panel ;
• serveur sous txAdmin : la console du panel n'atteint pas le serveur de jeu, donc Agora te dit de relancer par txAdmin (lien Ouvrir txAdmin pour relancer) ;
• serveur éteint : la ressource démarre avec lui.

Le message vert propose Redémarrer la ressource quand le serveur est connecté. Elle est active dès qu'elle annonce sa nouvelle version.

Méthode 2 — Par SFTP #

Ces champs ne s'affichent que sans panel relié.

1. Serveur → Panel, bloc Accès SFTP au serveur FiveM (sans panel) : hôte, port, utilisateur, mot de passe ou clé, dossier resources, et l'empreinte de la clé d'hôte.
2. Tester l'accès SFTP, puis Déployer par SFTP.
3. Dans la console du serveur de jeu, tape refresh puis ensure agora (ou redémarre).

Méthode 3 — À la main #

1. Administration → Configuration → Ressource Agora, bloc Installation, carte Télécharger agora.zip.

2. Dézippe dans resources/, en gardant le nom de dossier agora.

3. Dans server.cfg, après ton framework (qbx_core, qb-core ou es_extended), ajoute :

   Copier

   ensure agora

4. Redémarre le serveur, ou tape refresh puis ensure agora.

⚠ Garde le nom agora. Sous un autre nom, la tablette s'ouvre sur un cadre vide, et la console le dit au démarrage.

Ce que la ressource envoie #

Uniquement vers l'adresse de ton site, avec le secret partagé : la présence (qui est en ligne, avec quel personnage, quel job et quel grade, et s'il est en service), les positions quand la carte live est active, les portraits et photos de dossier. Pas de boucle ni de requête périodique en plus de la présence.

• Le grade voyage avec la présence : quand le jeu annonce un changement de job ou de grade, Agora resynchronise les rôles Discord de grade du membre (voir Rôles Discord, synchronisation et « Membre suspendu »). Une ressource plus ancienne ne signale que le changement de job : redéploie-la après une mise à jour d'Agora.
• Le texte d'un joueur montré à un autre (description d'un 911 chez les agents, nom de personnage ou raison d'échec dans le chat) est nettoyé avant l'affichage : balises (<, >) et caractères de contrôle retirés, car certains systèmes de notification et forks du chat rendent le HTML.

Vérifier #

1. Dans la console du serveur de jeu, cherche la ligne [agora] v0.3.3 — présence toutes les 30 s — framework : … puis [agora] présence : connecté à Agora.
2. Dans Agora, Serveur → Joueurs, encadré Serveur de jeu : « Dernier signal de la ressource agora : il y a quelques secondes ».
3. En jeu, tape /agora ou appuie sur F2.

Si rien n'arrive : Dépanner la ressource.