Comment connecter une base de données à votre serveur FiveM
Tout framework roleplay sérieux sur FiveM stocke ses données dans MySQL : personnages, métiers, véhicules, inventaires, comptes en banque. Votre serveur FiveM DoomHosting inclut un emplacement de base de données MySQL que vous créez vous-même depuis l'onglet Bases de données du panneau, et la connexion tient en une seule ligne dans server.cfg. Ce guide couvre la création de la base, la construction de la chaîne de connexion attendue par oxmysql, son ajout à la config et l'import d'un schéma ESX ou QBCore.
Ce qu'il vous faut
- Un serveur FiveM chez DoomHosting qui démarre déjà. S'il ne démarre pas encore, renseignez d'abord la clé de licence : comment obtenir une clé de licence FiveM.
- oxmysql, la ressource que tous les frameworks modernes utilisent pour parler à MySQL. ESX et QBCore la fournissent tous les deux.
- Un client MySQL sur votre PC si vous comptez importer un schéma de framework. HeidiSQL (Windows) et DBeaver (toutes plateformes) sont gratuits.
Créer la base de données dans le panneau
- Ouvrez vos serveurs de jeu et cliquez sur votre serveur FiveM.
- Dans la navigation de section, sous Avancé, ouvrez Bases de données.
- Cliquez sur Nouvelle base de données, saisissez un nom court (lettres, chiffres et underscores uniquement) et validez.
Nous créons la base et un utilisateur dédié avec un mot de passe généré. Le nom reçoit automatiquement un préfixe : une base que vous appelez esx devient donc quelque chose comme s1708_esx, et l'utilisateur ressemble à u1708_esxdemo.
La ligne affiche cinq boutons d'identifiants : Nom de la base de données, Hôte, Port, Nom d'utilisateur et Mot de passe, ce dernier restant masqué jusqu'à ce que vous cliquiez sur l'icône en forme d'œil. Un clic sur l'un d'eux en copie la valeur. Deux boutons se trouvent à droite : Nouveau mot de passe fait tourner le mot de passe (tout ce qui utilise encore l'ancien cesse aussitôt de fonctionner), et l'icône corbeille supprime définitivement la base et toutes ses données.
L'en-tête de la carte compte vos emplacements, par exemple 1 bases de données utilisées sur 1. Un emplacement suffit à une installation ESX ou QBCore normale, puisqu'un framework et toutes ses ressources partagent une seule base. Contactez le support si votre configuration en réclame vraiment une deuxième.
Ce qui va dans chaque champ
L'étape de configuration de txAdmin, HeidiSQL, DBeaver et la plupart des installateurs de framework demandent les mêmes cinq valeurs, chacune dans son propre champ. L'onglet Bases de données les affiche sous forme de cinq boutons de copie distincts, dans cet ordre exact : copiez chacune dans le champ portant le nom correspondant.
| Le champ dans l'outil | Ce que vous collez | Le bouton d'où il vient |
|---|---|---|
| Host, Server ou Hostname / IP | 203.0.113.10 |
Hôte, l'adresse seule, sans port derrière |
| Port | 3306 |
Port |
| Username ou User | u1708_esxdemo |
Nom d'utilisateur |
| Password | le mot de passe généré | Mot de passe, après un clic sur l'icône en forme d'œil |
| Database ou Database name | s1708_esx |
Nom de la base de données |
Trois de ces valeurs sont saisies de mémoire au lieu d'être copiées, et les trois échouent :
localhostn'est jamais l'hôte. Votre base de données tourne sur notre serveur de bases de données, pas dans le conteneur du serveur de jeu :localhostenvoie donc votre framework vers une machine sans MySQL. Utilisez l'adresse du bouton Hôte.rootn'est jamais le nom d'utilisateur. Vous recevez votre propre utilisateur, nomméusuivi du numéro de votre serveur. Un serveur de bases de données partagé n'a aucun accès root à distribuer, doncrootest refusé quel que soit le mot de passe.- Le nom de la base est celui que nous avons créé, pas un nom que vous choisissez. Il porte un préfixe,
s1708_esx, et un installateur qui propose son propre nom propose une base qui n'existe pas. Copiez le bouton Nom de la base de données.
Si un outil n'a pas de champ Port distinct mais un seul champ d'adresse, c'est exactement là que le port a sa place : 203.0.113.10:3306, adresse et port ensemble.
Récupérer votre chaîne de connexion
Vous n'avez pas à l'assembler à la main. Sur un serveur FiveM, l'onglet Bases de données affiche la ligne terminée pour votre première base sous la liste, avec un bouton de copie et une icône en forme d'œil qui y révèle le mot de passe. Copiez-la et passez directement à la section suivante.
Si vous préférez l'écrire vous-même, oxmysql lit une seule convar, mysql_connection_string, et accepte deux formats :
set mysql_connection_string "mysql://u1708_esxdemo:[email protected]:3306/s1708_esx"
set mysql_connection_string "user=u1708_esxdemo;password=YourPassword;host=203.0.113.10;port=3306;database=s1708_esx"
Chaque valeur vient de son propre bouton dans l'onglet Bases de données : user= depuis Nom d'utilisateur, password= depuis Mot de passe, host= depuis Hôte, port= depuis Port et database= depuis Nom de la base de données. Rien n'a besoin d'être coupé ni retouché au passage.
Utilisez le second format. Les mots de passe que nous générons mélangent lettres et chiffres avec des symboles pris dans l'ensemble ! @ = . + ^, et oxmysql documente ; , / ? : @ & = + $ # comme réservés à l'intérieur d'une chaîne de connexion. Un mot de passe contenant @, = ou + casse l'URI mysql:// en silence : l'analyseur lit une partie de votre mot de passe comme nom d'hôte et la connexion échoue alors que les identifiants sont parfaitement valides. La forme user=...;password=... n'a pas ce piège.
L'ajouter à server.cfg
- Ouvrez l'onglet Fichiers et cliquez sur
server.cfgpour l'éditer dans le navigateur. - Placez la chaîne de connexion au-dessus de toutes les lignes de ressources, puis démarrez oxmysql avant votre framework :
set mysql_connection_string "user=u1708_esxdemo;password=YourPassword;host=203.0.113.10;port=3306;database=s1708_esx"
ensure oxmysql
ensure es_extended
- Enregistrez le fichier, puis redémarrez le serveur depuis le haut du panneau. Les convars ne sont lues qu'au démarrage : une modification ne change rien tant que le serveur n'a pas redémarré.
Deux choses à ne pas toucher. Notre démarrage réécrit les lignes endpoint_add_tcp et endpoint_add_udp vers le port qui vous est attribué à chaque boot, il est donc inutile de les modifier. Et traitez server.cfg comme un fichier secret : il contient désormais le mot de passe de votre base à côté de votre clé de licence, ne le collez donc jamais dans un salon de support Discord sans masquer les deux.
Si vous avez activé txAdmin depuis le bouton Activer txAdmin de l'Aperçu, FXServer n'exécute plus directement /home/container/server.cfg. txAdmin prend la main sur le démarrage et lance le serveur depuis son propre dossier de données, /home/container/txData. Modifiez donc le server.cfg qui se trouve dans le dossier de déploiement, ou utilisez l'éditeur de CFG intégré à txAdmin. Vous accédez à l'interface web avec Ouvrir txAdmin sur l'Aperçu.
Installer oxmysql
Vérifiez d'abord resources. Les recettes ESX et QBCore incluent presque toujours oxmysql, et une seconde copie provoque un conflit de nom de ressource plutôt qu'un serveur plus rapide.
S'il manque, téléchargez la dernière version depuis le dépôt oxmysql, décompressez-la et envoyez le dossier oxmysql dans votre répertoire resources depuis l'onglet Fichiers. Ajoutez ensuite ensure oxmysql au-dessus des ressources de votre framework, comme montré plus haut. Si votre installation traîne encore mysql-async ou ghmattimysql, supprimez-les : oxmysql fournit leurs exports, et faire tourner les deux en même temps produit des gestionnaires de requêtes en double.
La documentation oxmysql couvre les extras, dont set mysql_debug true pour afficher chaque requête dans la console et set mysql_slow_query_warning 150 pour signaler les plus lentes.
Notes ESX et QBCore
Les deux frameworks interrogent la base via oxmysql : une seule chaîne de connexion sert donc au framework et à toutes les ressources posées dessus. Ce que ni l'un ni l'autre ne fait à votre place, c'est créer ses tables. Vous les importez vous-même :
- Installez HeidiSQL ou DBeaver sur votre PC.
- Créez une connexion MySQL ou MariaDB avec l'adresse Hôte et son port, plus le Nom d'utilisateur et le Mot de passe de l'onglet Bases de données. L'utilisateur que nous créons est autorisé à se connecter depuis n'importe quelle adresse : un client sur votre connexion personnelle fonctionne sans réglage supplémentaire.
- Sélectionnez votre base, ouvrez le fichier
.sqldu framework et exécutez-le.
Pour ESX, il s'agit du fichier SQL de es_extended plus ce que livre chaque addon. Voir la documentation ESX. Pour QBCore, importez d'abord le dump qb-core, puis les fichiers de chaque ressource, comme décrit dans la documentation QBCore. Importez le schéma avant le premier démarrage avec le framework activé, sinon la console se remplit d'erreurs de tables manquantes.
Un point utile sur les sauvegardes : les sauvegardes du panneau archivent les fichiers de votre serveur, pas la base MySQL. Exportez un dump .sql depuis votre client avant une grosse mise à jour de framework ou un wipe.
Problèmes courants
Failed to connect ou accès refusé au démarrage. Neuf fois sur dix, la chaîne indique encore localhost. Il n'y a pas de serveur MySQL à l'intérieur de votre conteneur de jeu : l'hôte doit être l'adresse affichée dans l'onglet Bases de données.
Access denied for user root. Il n'existe aucun accès root sur le serveur de bases de données. Copiez le bouton Nom d'utilisateur, qui vous donne u suivi du numéro de votre serveur.
Le port s'est retrouvé en double. Un outil doté de son propre champ Port attend uniquement l'adresse dans le champ hôte. Y coller 203.0.113.10:3306 laisse le port aux deux endroits et plus rien ne se résout.
Unknown database. Le nom présent dans la configuration n'est pas celui que nous avons créé. txAdmin comme les installateurs de framework proposent un nom de base à eux, et cette base n'existe pas. Copiez plutôt le bouton Nom de la base de données.
Les identifiants sont bons mais l'authentification échoue. Le mot de passe contient @, = ou + et vous utilisez le format mysql://. Passez à la forme user=...;password=...;host=.... Cliquer sur Nouveau mot de passe peut aussi vous donner un mot de passe plus propre, mais le second format reste la solution fiable.
Les ressources démarrent avant que la convar soit définie. oxmysql se connecte au moment où il démarre : la ligne set mysql_connection_string doit donc se trouver au-dessus de ensure oxmysql. Utilisez set, pas sets ni setr, qui publient la valeur à chaque joueur qui se connecte.
Rien n'a changé après modification de la config. Redémarrez le serveur. Un serveur en cours d'exécution ne relit jamais server.cfg.
Erreurs de table ou de colonne inconnue. La connexion fonctionne mais le schéma n'a jamais été importé, ou il l'a été dans la mauvaise base. Vérifiez dans HeidiSQL que les tables existent bien dans votre base préfixée, et pas dans une seconde que vous auriez créée à la main.
Vous avez modifié server.cfg mais txAdmin est activé. txAdmin fait tourner sa propre copie sous /home/container/txData. Modifiez celle-là, sinon le fichier que vous avez changé n'est tout simplement jamais lu.
L'onglet Bases de données indique que les bases ne sont pas disponibles. Votre serveur n'a pas d'emplacement de base de données. Contactez le support, nous regarderons le service.
Étapes suivantes
Votre framework a maintenant un endroit où ranger ses données. Si vous êtes encore en train de configurer le serveur, le guide de la clé de licence est ici : comment obtenir une clé de licence FiveM. Le détail des forfaits, du matériel et des tarifs se trouve sur la page hébergement de serveurs FiveM.
