Créer et gérer une base de données

Dès qu’un serveur de jeu doit mémoriser quelque chose entre deux redémarrages — des comptes, un inventaire, une économie, des sanctions — il lui faut une base de données MySQL. Cette page s’adresse à tout client qui installe un framework RP, un plugin de permissions ou une boutique en jeu, et qui doit remplir des champs « host », « user » et « password ».

Les bases se créent depuis le panel panel.cloudfive.xyz, dans la rubrique dédiée aux bases de données de votre serveur. Le nombre inclus dépend de votre offre.

Créer une base depuis le panel

1. Connectez-vous à panel.cloudfive.xyz et ouvrez votre serveur.

2. Ouvrez la rubrique qui liste les bases de données du serveur.

3. Lancez la création d’une nouvelle base, puis donnez-lui un nom court et explicite : esx, boutique, permissions. Pas d’espaces, pas d’accents, pas de tirets — des lettres minuscules, des chiffres et le tiret bas.

4. Laissez la valeur proposée dans le champ qui restreint les adresses autorisées à se connecter, si vous n’avez pas de besoin particulier.

5. Validez. Le panel crée la base, un utilisateur dédié et un mot de passe aléatoire.

6. Notez immédiatement les quatre valeurs affichées : adresse, port, nom de la base, nom d’utilisateur. Le mot de passe se révèle d’un clic.

Le nom final n’est pas celui que vous avez tapé

Le panel préfixe le nom de la base et celui de l’utilisateur pour les rendre uniques sur le serveur MySQL. Vous obtiendrez quelque chose comme s12_esx et u12_a1b2c3. C’est ce nom complet qu’il faut renseigner dans votre configuration, pas esx.

Récupérer ses identifiants de connexion

Les quatre valeurs affichées par le panel correspondent exactement aux quatre champs que vos plugins demandent :

Ce que le panel affiche	Ce que votre plugin appelle	Piège courant
Adresse / point de connexion	host, hostname, server	jamais localhost : la base est sur un autre serveur que le jeu
Port	port	souvent 3306, mais pas toujours : lisez la valeur affichée
Nom de la base	database, dbname, schema	le nom complet avec son préfixe
Utilisateur	user, username	le nom complet avec son préfixe, pas votre email

Le mot de passe se régénère depuis le panel si vous l’avez perdu. En revanche, changer le mot de passe casse immédiatement la connexion de votre serveur de jeu : pensez à le reporter dans la configuration, puis à redémarrer — voir Démarrer, arrêter et redémarrer.

Attention

Ces identifiants sont écrits en clair dans vos fichiers de configuration. N’envoyez jamais un server.cfg ou un config.yml complet sur un salon Discord public sans remplacer le mot de passe par XXXX. Même précaution pour les extraits de logs : voir Console et logs.

Pour FiveM, le format de la chaîne de connexion attendue par oxmysql est détaillé dans Connecter la base de données (oxmysql).

Se connecter avec phpMyAdmin ou un client externe

Deux façons de regarder l’intérieur d’une base.

Si le panel propose un lien phpMyAdmin à côté de votre base, c’est le plus simple : tout se passe dans le navigateur, avec le nom d’utilisateur et le mot de passe de la base.

Sinon, utilisez un client installé sur votre machine. Gratuits et éprouvés : HeidiSQL (Windows), DBeaver (Windows, macOS, Linux), MySQL Workbench. La configuration est toujours la même.

1. Installez le client de votre choix, puis créez une nouvelle connexion de type MySQL / MariaDB.

2. Renseignez l’adresse et le port donnés par le panel — pas localhost.

3. Renseignez l’utilisateur et le mot de passe de la base.

4. Connectez-vous, puis dépliez votre base : vous devez voir ses tables, ou une base vide si le jeu ne l’a pas encore initialisée.

5. Si la connexion est refusée, vérifiez le champ des adresses autorisées dans le panel : une base restreinte à une seule adresse refuse tout le reste.

Un doute sur une requête ?

Travaillez sur une copie. Exportez la base, importez-la sous un autre nom si votre offre le permet, et testez là. Une requête UPDATE sans WHERE sur une base de production se répare rarement.

Importer et exporter des données

La plupart des frameworks livrent un fichier .sql à importer avant le premier démarrage. L’export, lui, est votre filet de sécurité.

Avec phpMyAdmin ou un client graphique, la fonction d’import attend votre fichier .sql ; la fonction d’export produit un fichier à conserver chez vous. En ligne de commande, depuis votre propre machine, les deux outils standards de MySQL suffisent :

Importer un fichier SQL dans sa base

mysql -h adresse-affichee-par-le-panel -P port -u u12_a1b2c3 -p s12_esx < schema.sql

Exporter sa base dans un fichier

mysqldump -h adresse-affichee-par-le-panel -P port -u u12_a1b2c3 -p s12_esx > sauvegarde-2026-11-09.sql

Le -p sans valeur demande le mot de passe de façon interactive : ne l’écrivez pas dans la commande, il resterait dans l’historique de votre terminal.

Trois points d’attention :

• Un gros fichier .sql échoue souvent dans le navigateur. Au-delà de quelques dizaines de mégaoctets, passez par un client ou par la ligne de commande.
• Importez avant le premier démarrage quand le framework le demande, sinon le serveur crée des tables incomplètes et le schéma entre en conflit.
• Vérifiez l’ordre des fichiers. Certains frameworks livrent plusieurs .sql à importer dans un ordre précis ; leur documentation le précise.

Bonnes pratiques de sauvegarde

Les sauvegardes du panel n’emportent pas votre base

Les sauvegardes du serveur de jeu archivent les fichiers de votre serveur. La base de données, elle, vit sur un serveur MySQL séparé : elle n’est pas dans l’archive. Restaurer une sauvegarde ne ramènera pas vos comptes joueurs. Voir Sauvegardes du serveur de jeu.

Ce qui marche en pratique :

1. Exportez la base avant toute opération sensible : mise à jour du framework, installation d’un gros script, wipe, changement de version.
2. Prenez un export régulier et conservez-le ailleurs que sur le serveur — sur votre machine ou sur un stockage externe. Un export qui dort sur le serveur disparaît avec lui.
3. Datez vos fichiers (sauvegarde-2026-11-09.sql) et gardez les trois derniers. Une sauvegarde unique écrasée chaque jour ne protège pas d’une corruption qui passe inaperçue une semaine.
4. Testez une restauration au moins une fois. Une sauvegarde jamais restaurée est une hypothèse, pas une sauvegarde.

La suppression d’une base est définitive

Supprimer une base depuis le panel détruit la base, son utilisateur et son contenu, sans corbeille et sans retour possible. Exportez-la d’abord, même si vous êtes certain de ne plus en avoir besoin.

Combien de bases selon l’offre

Le nombre de bases incluses dépend du palier commandé. Les valeurs publiées :

Offre	Bases incluses
FiveM Starter	2
FiveM Essentiel, FiveM Avantage	3
FiveM Performant	4
Minecraft Essentiel, Minecraft Avantage	3
Minecraft Performant	4

Pour les autres jeux et les autres paliers, reportez-vous à la page de votre offre sur cloudfive.fr — par exemple l’hébergement FiveM ou l’hébergement Minecraft. Si la création d’une base supplémentaire est refusée, c’est en général que le quota de l’offre est atteint : passer à un palier supérieur est possible à tout moment, voir Changer de formule.

Note

Un seul framework a besoin d’une seule base. Il est inutile — et contre-productif — d’en créer une par script : presque tous les plugins savent cohabiter dans la même base, chacun avec ses tables.

Si ça ne marche pas

Le serveur de jeu affiche une erreur de connexion à la base. Relisez les quatre valeurs une par une dans la configuration. Dans l’ordre de fréquence : localhost laissé à la place de l’adresse réelle, préfixe oublié sur le nom de la base ou de l’utilisateur, mot de passe recopié avec un espace en trop, port par défaut laissé alors que le panel en affiche un autre.

La connexion marche depuis mon PC mais pas depuis le serveur de jeu. C’est presque toujours une configuration non rechargée : un serveur de jeu lit ses fichiers au démarrage. Redémarrez-le.

« Access denied for user ». Mot de passe erroné, ou connexion refusée depuis cette adresse. Régénérez le mot de passe depuis le panel, reportez-le dans la configuration, redémarrez.

« Unknown database ». Le nom saisi ne correspond pas au nom complet préfixé, ou la base a été supprimée. Recopiez le nom affiché par le panel.

L’import s’arrête au milieu. Le fichier est trop gros pour l’outil utilisé, ou il contient une instruction incompatible avec la version de MySQL. Passez en ligne de commande : le message d’erreur y est précis, il indique la ligne fautive.

Rien de tout cela. Ouvrez un ticket de support en indiquant le nom de la base, le message d’erreur exact et le framework concerné — sans le mot de passe. Pour une base liée à un site et non à un jeu, c’est une autre page : Bases de données MySQL de l’hébergement web.