Sans base de données MySQL correctement configurée, aucun serveur FiveM RP ne démarre. C'est elle qui stocke les personnages, l'argent et l'inventaire. Voici comment configurer MySQL sur FiveM, proprement et sans erreur de connexion.
Pourquoi FiveM a besoin de MySQL
Dès que votre serveur utilise un framework (ESX ou QBCore), il s’appuie sur une base de données MySQL pour fonctionner. C’est elle qui garde en mémoire tout ce qui doit persister d’une session à l’autre :
- Les personnages et leur apparence.
- L’argent en banque et en liquide.
- L’inventaire et les objets possédés.
- Les véhicules, propriétés et jobs.
Sans elle, rien n’est sauvegardé : à chaque reconnexion, les joueurs repartiraient de zéro. Pire, un framework ne démarre tout simplement pas s’il ne parvient pas à joindre sa base. C’est pourquoi une configuration MySQL propre est une étape incontournable, et l’une des plus sources d’erreurs pour les débutants.
Étape 1 : créer la base de données
La première chose à faire est de créer une base vide qui accueillera votre framework. La plupart des hébergeurs fournissent phpMyAdmin, une interface web qui simplifie l’opération.
La procédure :
- Connectez-vous à phpMyAdmin avec vos identifiants.
- Créez une nouvelle base, par exemple
fivem_db. - Choisissez l’interclassement
utf8mb4_general_cipour gérer correctement tous les caractères. - Notez le nom de la base, l’utilisateur et le mot de passe associés.
Veillez à ce que l’utilisateur MySQL dispose de tous les droits sur cette base (lecture, écriture, création de tables). Un utilisateur aux droits trop limités provoque des erreurs au moment de l’import du schéma.
Bon à savoir : chez TalCloud, MySQL et phpMyAdmin sont préinstallés. La base et l'utilisateur sont déjà créés, et leurs identifiants vous attendent dans votre panel. Vous sautez directement à la connexion.
Étape 2 : installer oxmysql
oxmysql est la ressource qui fait le pont entre FiveM et votre base de données. C’est aujourd’hui le standard, plus rapide et mieux maintenu que les anciens connecteurs.
Comme tout script FiveM, il se place dans le dossier resources/ puis s’active dans le server.cfg. Point crucial : oxmysql doit être activé avant votre framework et avant tout script qui touche à la base.
ensure oxmysql
ensure es_extendedSi vous n’êtes pas à l’aise avec l’ajout de ressources, notre tutoriel ajouter des scripts FiveM détaille la manipulation. L’ordre d’activation est ici déterminant : un framework chargé avant oxmysql échouera systématiquement.
Étape 3 : renseigner la chaîne de connexion
C’est l’étape la plus sensible. oxmysql a besoin de savoir comment joindre votre base. Cette information se renseigne dans le server.cfg via la variable mysql_connection_string.
Le format ressemble à ceci :
set mysql_connection_string "mysql://utilisateur:motdepasse@localhost/fivem_db?charset=utf8mb4"Chaque élément doit correspondre exactement à votre configuration :
| Élément | Signification |
|---|---|
| utilisateur | Votre utilisateur MySQL |
| motdepasse | Son mot de passe |
| localhost | L’hôte de la base |
| fivem_db | Le nom de la base |
La moindre faute de frappe ici, et le serveur refuse de démarrer. Vérifiez surtout qu’aucun caractère spécial du mot de passe ne casse la chaîne. Si tel est le cas, ce guide sur un serveur FiveM qui ne démarre pas couvre justement ce scénario.
Étape 4 : importer le schéma du framework
Une base vide ne suffit pas : il faut y créer les tables attendues par votre framework. Chaque framework fournit un fichier .sql à importer.
La marche à suivre dans phpMyAdmin :
- Sélectionnez votre base
fivem_db. - Ouvrez l’onglet Importer.
- Choisissez le fichier
.sqlfourni avec ESX ou QBCore. - Lancez l’import et attendez la confirmation.
Si vous avez déployé votre serveur via une recipe txAdmin, cette étape a souvent été réalisée automatiquement. Vérifiez simplement que les tables principales (comme users ou players) sont bien présentes.
Étape 5 : tester la connexion
Démarrez le serveur et observez la console. Si oxmysql se connecte correctement, vous verrez un message confirmant le nombre de connexions établies à la base. Aucune erreur rouge liée à MySQL ne doit apparaître.
Testez ensuite en jeu : créez un personnage, gagnez de l’argent, déconnectez-vous puis reconnectez-vous. Si vos données sont conservées, votre configuration MySQL est opérationnelle.
En cas de souci, les causes les plus fréquentes sont une chaîne de connexion erronée, un utilisateur sans droits suffisants ou un service MySQL arrêté. Sur un hébergement FiveM géré, ces points sont déjà réglés et la base répond instantanément grâce au stockage NVMe.
En résumé
Configurer MySQL sur FiveM suit cinq étapes : créer une base vide, installer oxmysql en le chargeant avant le framework, renseigner soigneusement la chaîne de connexion, importer le schéma SQL, puis tester la persistance des données en jeu. L’erreur la plus courante reste une mysql_connection_string mal écrite. Soignez cette ligne, respectez l’ordre d’activation, et votre base tiendra la charge sans broncher.