Connecter une base de données MySQL à votre serveur FiveM

Ce guide vous explique comment connecter une base de données MySQL à votre serveur FiveM hébergé chez OneSubnet. Une base de données est indispensable pour la plupart des frameworks roleplay (ESX, QBCore) et de nombreux scripts.

Informations de connexion

Voici les informations de connexion à votre base de données :

La base de données est hébergée localement sur le même serveur que votre serveur FiveM, d'où l'utilisation de 127.0.0.1.

Créer votre base de données

Avant de configurer votre serveur FiveM, vous devez créer une base de données via votre panel :

1. Connectez-vous à votre panel de gestion (game.onesubnet.com)
2. Accédez à votre serveur FiveM
3. Dans l'onglet Databases, cliquez sur Create Database
4. Notez le nom de la base de données, le nom d'utilisateur et le mot de passe qui vous sont fournis

Installer le script oxmysql

oxmysql est le connecteur MySQL recommandé pour FiveM. Il remplace les anciens connecteurs comme mysql-async ou ghmattimysql.

1. Téléchargez oxmysql depuis les releases officielles : GitHub - oxmysql
2. Placez le dossier oxmysql dans le répertoire resources/ de votre serveur
3. Assurez-vous que oxmysql est le premier resource à être chargé dans votre server.cfg

Configurer le fichier server.cfg

Ajoutez les lignes suivantes dans votre fichier server.cfg, avant toute autre resource :

set mysql_connection_string mysql://utilisateur:mot_de_passe@127.0.0.1:3306/nom_de_la_base?charset=utf8mb4

ensure oxmysql

Explication des paramètres

Exemple complet de connexion

Si votre panel vous a fourni les informations suivantes :

• Utilisateur : ptero_5f8a2b
• Mot de passe : kX9mP2vL7n
• Base de données : ptero_5f8a2b_fivem

Votre configuration sera :

set mysql_connection_string mysql://ptero_5f8a2b:kX9mP2vL7n@127.0.0.1:3306/ptero_5f8a2b_fivem?charset=utf8mb4

ensure oxmysql

Vérifier la connexion

Pour vérifier que votre base de données est correctement connectée :

1. Démarrez (ou redémarrez) votre serveur FiveM
2. Consultez la console du serveur
3. Vous devriez voir un message confirmant que oxmysql s'est connecté avec succès
4. Si vous voyez une erreur Access denied, vérifiez vos identifiants
5. Si vous voyez Connection refused, vérifiez que le port est bien 3306

Importer un fichier SQL

De nombreux scripts et frameworks fournissent un fichier .sql à importer dans votre base de données :

1. Depuis votre panel, accédez à l'onglet Databases
2. Cliquez sur le bouton d'importation à côté de votre base de données
3. Sélectionnez le fichier .sql fourni par le script/framework
4. L'importation se lance automatiquement

Vous pouvez également utiliser phpMyAdmin si disponible, ou importer via la console avec :

mysql -u utilisateur -p nom_de_la_base < fichier.sql

Erreurs courantes

Access denied for user

Votre identifiant ou mot de passe est incorrect. Vérifiez les informations fournies lors de la création de la base de données.

Unknown database

Le nom de la base de données est incorrect ou la base n'a pas encore été créée. Vérifiez le nom exact dans votre panel.

Connection refused

Le serveur MySQL n'est pas accessible. Assurez-vous que l'hôte est bien 127.0.0.1 et le port 3306.

oxmysql not found

Le resource oxmysql n'est pas présent dans votre dossier resources/ ou n'est pas correctement nommé.