FiveM oxmysql : configurer la base SQL proprement sans bloquer son serveur

Sur un serveur FiveM, la base SQL est au coeur de beaucoup de ressources : economie, inventaire, jobs, garages, permissions, personnages. Quand oxmysql est mal configure, le serveur peut demarrer avec des erreurs, bloquer des scripts ou perdre des donnees.

Ce guide pose une base propre pour comprendre ce qu'il faut configurer et dans quel ordre.

Resume rapide

Pour configurer oxmysql :

• Installe MariaDB ou MySQL.

• Cree une base dediee au serveur FiveM.

• Cree un utilisateur SQL dedie.

• Importe les fichiers .sql des ressources.

• Configure la connection string.

• Assure-toi qu'oxmysql demarre avant les ressources qui l'utilisent.

• Lis les logs au premier demarrage.

Pourquoi oxmysql est important

oxmysql fait le lien entre FiveM et la base de donnees. Les scripts n'ecrivent pas "magiquement" leurs donnees : ils passent par une couche SQL.

Si cette couche est lente ou mal configuree, les problemes peuvent ressembler a :

• Personnage qui ne charge pas.

• Inventaire vide.

• Erreurs au demarrage.

• Jobs non sauvegardes.

• Requetes qui timeout.

• Console remplie d'erreurs SQL.

Base SQL : eviter le compte root

N'utilise pas le compte SQL root pour ton serveur FiveM. Cree un utilisateur dedie avec acces uniquement a la base du serveur.

Exemple logique :

CREATE DATABASE fivem_prod CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem_user'@'localhost' IDENTIFIED BY 'mot_de_passe_fort';
GRANT ALL PRIVILEGES ON fivem_prod.* TO 'fivem_user'@'localhost';
FLUSH PRIVILEGES;

Adapte le nom, l'utilisateur et le mot de passe. L'important est de limiter les droits a ce qui est necessaire.

Connection string oxmysql

La connection string indique a oxmysql comment joindre la base.

Exemple local :

set mysql_connection_string "mysql://fivem_user:mot_de_passe_fort@localhost/fivem_prod?charset=utf8mb4"

Points a verifier :

• Nom de base correct.

• Mot de passe sans erreur de caractere.

• Hote correct : localhost si la base est sur le meme VPS.

• Charset compatible.

• Ligne placee au bon endroit dans la configuration.

Ordre de demarrage des ressources

oxmysql doit demarrer avant les ressources qui en dependent.

Exemple :

ensure oxmysql
ensure framework
ensure inventory
ensure jobs

Si une ressource demarre avant oxmysql, elle peut echouer au chargement meme si la base est correcte.

Importer les fichiers SQL proprement

Beaucoup de ressources FiveM fournissent un fichier .sql. Ne les importe pas au hasard.

Bonne methode :

1. Sauvegarder la base. 2. Lire le fichier SQL. 3. Verifier s'il cree des tables ou modifie des tables existantes. 4. Importer sur une base de test si possible. 5. Redemarrer et verifier les logs.

Une erreur classique : importer deux scripts qui creent des tables incompatibles ou ecrasent une structure existante.

Erreurs frequentes

Access denied

Le nom d'utilisateur, le mot de passe ou l'hote SQL est incorrect. Verifie aussi que l'utilisateur a les droits sur la bonne base.

Unknown database

La base indiquee dans la connection string n'existe pas, ou le nom ne correspond pas.

Table doesn't exist

La ressource attend une table qui n'a pas ete importee. Relis la documentation de la ressource et importe le fichier SQL correspondant.

Timeout SQL

Ca peut venir d'une base surchargee, d'une requete lourde, d'un VPS trop limite ou d'une ressource mal codee.

Bonnes pratiques VPS

• Base SQL locale pour commencer.

• Utilisateur SQL dedie.

• Sauvegarde automatique de la base.

• Pas de port MySQL expose publiquement si inutile.

• Mises a jour planifiees.

• Logs surveilles apres ajout d'une ressource.

Si la base est distante, securise le flux. N'expose pas MySQL a Internet avec un mot de passe faible en esperant que personne ne scanne.

Recommandation SwiftHeberg

Un serveur FiveM stable depend autant du VPS que de la proprete des ressources. Prends une machine avec assez de CPU, de RAM et un disque rapide. Mais surtout, garde une configuration lisible : quand un probleme SQL arrive, la clarte fait gagner des heures.

FAQ

MariaDB ou MySQL pour FiveM ?

Les deux peuvent fonctionner selon les ressources. MariaDB est souvent utilisee sur Debian. Le plus important est la compatibilite avec tes scripts et une configuration propre.

Puis-je heberger la base sur un autre serveur ?

Oui, mais ce n'est pas toujours utile au depart. Une base distante ajoute de la latence et de la securite a gerer.

Faut-il sauvegarder la base tous les jours ?

Oui pour un serveur actif. La base contient souvent les donnees les plus importantes des joueurs.