Ton premier jour avec Agora : la liste dans l'ordre

En bref. Voici le parcours complet, dans l'ordre, pour aller d'une machine vide à une tablette qui marche en jeu. Chaque étape renvoie vers son article et dit à quoi tu reconnais qu'elle est terminée : ne passe à la suivante qu'à ce moment-là.

Les étapes 1 à 5 suffisent pour avoir ton Hub (ton site Agora) et son forum. Les étapes 6 à 9 branchent ton serveur de jeu et ouvrent le MDT et la tablette.

Avant de commencer #

• Un compte Discord : toute connexion à Agora passe par lui.
• Pour les étapes 6 à 9, l'accès à ton serveur FiveM (le fichier server.cfg et le dossier resources, par ton hébergeur ou par SFTP).
• Un mot t'arrête ? Il est expliqué dans le glossaire.

Les étapes dans l'ordre #

Installer le Hub #

1. Vérifie ce qu'il te faut. Une machine ou un panel, une clé de licence, un accès à Internet et une application Discord. Voir Prérequis. C'est fini quand tu sais où Agora va tourner.
2. Récupère ta clé de licence. L'essai gratuit est une vraie clé, valable 14 jours, à demander dans ton espace sur agorapanel.com. Le compte à rebours ne démarre qu'au premier lancement de ton installation. Voir L'essai gratuit de 14 jours. C'est fini quand tu as ta clé (elle commence par AGORA-) ou un fichier d'installation qui la contient déjà.
3. Choisis ta voie d'installation. Docker sur une machine à toi, œuf sur un panel Pterodactyl ou Pelican, ou serveur Node.js d'un hébergeur ordinaire. Voir Choisir entre Docker, l'œuf de panel et un serveur Node.js. C'est fini quand tu sais laquelle des trois voies est la tienne.
4. Installe Agora. Suis l'article de ta voie : Installer avec Docker, Installer sur Pterodactyl, Installer sur Pelican ou Installer sur un serveur Node.js d'hébergeur (tu ne sais pas lequel des deux panels tu as ? Voir Reconnaître Pelican ou Pterodactyl). Tu n'as aucune base de données à préparer pour le Hub : voir Les deux bases d'Agora. <!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre) --> C'est fini quand la console affiche Ready in … (le premier démarrage télécharge Agora : compte quelques minutes).
5. Fais la mise en route. Ouvre ton Hub dans un navigateur (http://IP:PORT) : l'écran de mise en route te guide en trois étapes. Voir Premier démarrage et mise en route. C'est fini quand tu es administrateur : la barre du haut affiche Modération, Serveur et Administration.

Brancher ton serveur de jeu #

6. Branche la base du jeu. C'est la base MySQL ou MariaDB de ton serveur FiveM, celle qui contient déjà tes personnages. Lis d'abord Les deux bases d'Agora, puis Brancher la base de données du serveur de jeu. C'est fini quand le bouton Tester affiche la version de MySQL et le nombre de personnages.
7. Rattache tes jobs au MDT. Dis à Agora quels jobs et quels grades forment la police, les EMS, la justice… Voir Configurer le MDT. C'est fini quand chaque service du MDT a ses jobs.
8. Mets le Hub en HTTPS si besoin. La ressource FiveM refuse de parler à un site en http:// sur une adresse publique. Si ton Hub n'est joignable que par http:// et une adresse publique, passe d'abord en HTTPS : voir Derrière un proxy. Une adresse de ton réseau local convient sans HTTPS. C'est fini quand ton site s'ouvre avec le cadenas, ou par une adresse locale.
9. Installe la ressource FiveM et relie ton jeu. Dépose la ressource agora sur ton serveur de jeu (un clic si ton panel est relié avec le palier Pro, sinon en déposant le zip à la main), puis relie ton compte à ton jeu avec un code. Voir Installer la ressource FiveM agora et Relier son jeu à son compte. C'est fini quand tu ouvres la tablette en jeu (/agora ou F2) et que ton personnage s'affiche.

Faire le tour et mettre en sécurité #

10. Découvre l'interface. Voir Se repérer. C'est fini quand tu sais ce qu'on trouve dans Modération, Administration et Serveur.
11. Relie le bot Discord (facultatif). Il donne automatiquement les rôles Discord de tes groupes. Voir Relier Discord et Créer et configurer ton bot Discord. C'est fini quand la bannière affiche « Bot connecté ».
12. Fais une première sauvegarde. Voir Sauvegardes et restauration. C'est fini quand une sauvegarde apparaît dans la liste de Administration → Agora.

Tu sais que c'est réussi quand… #

• Un joueur ouvre la tablette en jeu et voit son personnage.
• Dans un navigateur, tu vois les entrées Modération, Serveur et Administration de la barre du haut.
• Administration → Agora affiche « Essai » ou « Actif », sans « Dernière erreur ».
• L'adresse /api/health de ton Hub répond "ok": true.

Si tu es bloqué #

Pour aller plus loin #

• Organise ton équipe : Groupes et permissions et Gérer les membres.
• Règle le nom, le logo et la page d'accueil de ton site : Les paramètres du site et la page d'accueil.
• Ouvre les candidatures de ta whitelist : Candidatures et examens.
• Comprends ce que couvre ta licence : Les paliers Basic et Pro.