Brancher la base de données du serveur de jeu

En bref. Le MDT, la carte live, la RH et la concession lisent la base MySQL ou MariaDB de ton serveur de jeu. Sans elle, le forum marche, le reste non. Tout se règle dans Serveur → Base de données, encadré Connexion à la BD du jeu.

Ce qu'Agora fait dans ta base #

• Il lit les personnages, jobs, grades et véhicules, sans les modifier.
• Il crée ses propres tables, préfixées agora_, pour les dossiers du MDT. Aucune clé étrangère sur tes tables.
• Il écrit dans tes tables seulement pour la concession (débit et véhicule livré).

1. Créer un utilisateur MySQL dédié #

N'utilise pas root. L'utilisateur doit pouvoir se connecter depuis l'adresse IP de la machine d'Agora :

CREATE USER 'agora'@'203.0.113.10' IDENTIFIED BY 'un-mot-de-passe-long';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, ALTER, REFERENCES
  ON `nom_de_ta_base`.* TO 'agora'@'203.0.113.10';
FLUSH PRIVILEGES;

Remplace 203.0.113.10 par l'IP d'Agora, et nom_de_ta_base par la base de ton framework. Sans CREATE, le MDT ne peut pas créer ses tables.

2. Trouver l'hôte #

Agora tourne dans un conteneur : pour lui, localhost et 127.0.0.1 désignent le conteneur lui-même.

Avec un panel relié (Serveur → Panel), Détecter la configuration remplit tout seul les identifiants MySQL et nomme le framework trouvé. Si le framework est sur Automatique, il le reste : la détection du panel ne fige pas le choix.

Si une autre base du jeu est déjà réglée, la détection ne l'écrase pas : elle affiche « BD du panel trouvée (…) mais PAS enregistrée : une autre base du jeu est déjà réglée… » et un bouton Remplacer la base du jeu par celle du panel. Clique dessus seulement si c'est bien la base à utiliser.

3. Remplir le formulaire #

Serveur → Base de données, Connexion à la BD du jeu :

1. Framework : laisse Automatique (recommandé), le choix par défaut d'une nouvelle installation. Ne choisis ESX, QBCore ou QBox que pour le fixer.
2. Hôte, Port (3306), Utilisateur, Mot de passe, Base. Le port doit être un nombre de 1 à 65535 : sinon l'enregistrement est refusé avec un message, au lieu d'écrire une valeur qui ne marchera pas.
3. Colonne Discord ID : laisse la détection automatique.
4. Enregistre, puis clique sur Tester.

Réponse attendue : la version de MySQL et le nombre de personnages. En Automatique, le test nomme aussi le framework retenu et d'où il vient, par exemple « Framework : QBox (automatique, d'après les tables de la base) ». Le mot de passe est chiffré au repos.

Le framework : Automatique ou fixe #

En Automatique, Agora retrouve seul le framework en croisant ce que la ressource en jeu annonce à son démarrage et les tables présentes dans ta base. Sous le menu, l'écran dit ce qui est détecté maintenant, « Détecté : QBox (annoncé par la ressource en jeu) », ou « Non détecté : … » avec la raison.

Si la détection ne peut pas trancher (base sans tables de framework, tables d'ESX et de QBCore dans la même base, ou désaccord avec la ressource), Agora ne devine pas : le MDT, la carte live et le portail ne lisent aucun personnage tant que rien n'est détecté, et l'écran dit pourquoi. Corrige la cause, ou fixe le framework dans le menu.

Une installation qui avait déjà enregistré un framework le garde tel quel. Pour passer en Automatique, choisis Automatique et enregistre. Détails : Frameworks pris en charge.

4. Relier les jobs #

Ensuite, rattache tes jobs au MDT : Configurer le MDT.

Comment un joueur retrouve ses personnages #

Par sa licence FiveM, une fois qu'il a relié son jeu (un code à saisir dans la tablette). La colonne Discord de ta base ne suffit plus : n'importe quel joueur peut annoncer le Discord d'un autre. Voir Relier son jeu.

En cas d'échec #

Voir Base du jeu injoignable.