Configurer la connexion SQL dans server.cfg (FiveM)

Configurer la connexion SQL dans server.cfg (FiveM)

Table des matières

Pourquoi configurer la ligne SQL ?

Votre serveur FiveM a besoin d'une connexion à une base de données MySQL pour faire fonctionner vos scripts (inventaire, véhicules, joueurs...). Cette connexion est définie dans le fichier server.cfg via la variable set mysql_connection_string.

Bonne nouvelle : OneHeberge intègre un outil qui génère cette ligne automatiquement. Pas besoin de la construire à la main.

Étape 1 — Accéder à l'outil Base de données

Depuis votre panel game.oneheberge.fr, sélectionnez votre serveur FiveM puis cliquez sur l'onglet Base de données.

Vous y trouverez :

  • L'IP de la base de données
  • Le nom de la base
  • Le nom d'utilisateur
  • Le mot de passe

Étape 2 — Générer la ligne automatiquement

En bas de cet onglet, vous trouverez un formulaire intégré OneHeberge. Renseignez les 4 champs (IP, nom de base, utilisateur, mot de passe) puis cliquez sur Enregistrer.

La ligne set mysql_connection_string est alors générée et insérée automatiquement dans votre fichier server.cfg.

Étape 3 — Vérifier dans la section Démarrage du server.cfg

⚠️ Important : La ligne SQL doit impérativement se trouver dans la section Démarrage de votre server.cfg, et non ailleurs dans le fichier.

Pour vérifier ou insérer manuellement la ligne :

  1. Allez dans l'onglet Fichiers de votre serveur sur le panel
  2. Ouvrez le fichier server.cfg
  3. Repérez la section Démarrage (là où se trouvent les start <resource>)
  4. Insérez ou vérifiez que la ligne suivante est bien présente dans cette section :
set mysql_connection_string "mysql://UTILISATEUR:MOT_DE_PASSE@IP/NOM_BASE?charset=utf8mb4"

Si la ligne est ailleurs dans le fichier (avant les ensure par exemple), déplacez-la dans la section Démarrage.

Étape 4 — Redémarrer le serveur

Une fois la ligne en place, redémarrez votre serveur depuis l'onglet Console du panel. Dans les logs, vous devriez voir la connexion MySQL s'établir sans erreur.

Problèmes fréquents

  • Erreur "connection refused" : vérifiez que l'IP saisie est bien celle fournie par le panel, pas "localhost".
  • Erreur "access denied" : le mot de passe ou le nom d'utilisateur est incorrect.
  • La ligne est ignorée : elle n'est pas dans la section Démarrage — déplacez-la.