Configuration d'une base de données FiveM avec l'onglet Configuration MySQL

La plupart des frameworks FiveM, tels que QBCore, Qbox et ESX, nécessitent une base de données MySQL. Sur ServerPrism, l'onglet Configuration MySQL vous guide: il définit votre clé de licence, crée un serveur de base de données MariaDB à partir de votre plan actuel, crée un utilisateur de base de données et écrit la chaîne de connexion dans votre server.cfg. Ce guide suit l'onglet étape par étape.

Ouvrez votre serveur FiveM et cliquez sur Configuration MySQL dans la barre latérale (sous FiveM). Le haut de la page indique le nombre d'étapes restantes. Vous pouvez Skip setup à tout moment et Resume setup plus tard.

Étape 1: Clé de licence FiveM

FiveM nécessite une clé de licence gratuite de keymaster.fivem.net. Connectez-vous, créez une clé de serveur, copiez-la, collez-la dans License key et cliquez sur Save.

La clé est enregistrée dans le paramètre FxServer License Key de l'onglet Démarrage, vous pouvez donc également la modifier ultérieurement.

Si vous voyez Server ports need attention, cliquez sur Auto-fix ports. Un serveur FiveM avec txAdmin nécessite trois ports consécutifs et le port txAdmin doit en faire partie; la correction configure cela pour vous. Les serveurs sans txAdmin (voir étape 5) ignorent cette vérification.

Étape 2: Serveur de base de données

Votre base de données fonctionne comme son propre petit serveur à côté de votre serveur FiveM.

1. L'onglet montre comment votre plan serait divisé, par exemple "FiveM (ce serveur)" et "MariaDB (nouveau)", chacun avec sa RAM. Il n'y a aucun coût supplémentaire: les ressources de votre plan sont divisées entre les deux.
2. Cliquez sur Create MariaDB server et confirmez.

Votre serveur FiveM redémarre brièvement pendant l'exécution de la division. Le nouveau serveur de base de données démarre ensuite de lui-même. S'il apparaît hors ligne plus tard, cliquez sur Start database.

Le propriétaire peut également choisir Custom split pour sélectionner les tailles dans l'onglet Diviser le serveur. Vous pouvez également annuler une division là-bas.

Étape 3: Utilisateur de base de données

Cliquez sur Provision database user. Nous créons un utilisateur et une base de données appelée fivem_db avec un mot de passe aléatoire fort, et enregistrons les détails afin que vous ne le fassiez qu'une seule fois.

Vous verrez alors Database details for txAdmin setup: Host, Port, Database name, Username et Password, chacun avec un bouton de copie. Copy all (txAdmin format) copie tout en une seule fois, prêt à être collé dans l'étape de la base de données de txAdmin. Sur un serveur sans txAdmin, la carte s'appelle Database details et le bouton Copy all; utilisez les détails dans vos ressources, ou laissez l'étape 4 les écrire dans server.cfg.

La même carte a un bouton Reset password lorsque vous avez besoin d'un nouveau mot de passe de base de données (voir "Changer le mot de passe de la base de données" ci-dessous).

Étape 4: Appliquer aux fichiers .cfg

Cliquez sur Rescan, puis sur Apply connection string. Nous parcourons vos fichiers .cfg et écrivons une ligne comme celle-ci dans le bon fichier:

set mysql_connection_string "mysql://USER:PASSWORD@HOST:PORT/fivem_db?charset=utf8mb4"

Si aucune ligne n'existe encore, elle est ajoutée au server.cfg que votre serveur charge réellement. Le fichier que FXServer charge est marqué Active; les autres fichiers server.cfg dans les dossiers de ressources ou les modèles de recettes ne sont que des exemples.

Redémarrez votre serveur après l'application, afin que les ressources comme oxmysql prennent en compte la nouvelle connexion.

Étape 5: Démarrer le serveur (et ouvrir txAdmin)

Lorsque toutes les étapes sont terminées (ou ignorées), une dernière carte apparaît vous indiquant que tout est prêt.

1. Cliquez sur Démarrer le serveur. FXServer prend 30 à 60 secondes pour être en ligne.
2. Cliquez sur Open txAdmin. L'txAdmin URL est affichée sur la carte avec un bouton de copie.
3. La première fois, txAdmin demande un code PIN. Vous le trouverez dans la Console.
4. Créez votre compte administrateur txAdmin, puis choisissez une recette (QBCore, ESX, etc.). Lorsque txAdmin demande les détails de la base de données, collez ce que vous avez copié à l'étape 3.

Une fois que txAdmin a configuré votre recette, revenez à Configuration MySQL et exécutez à nouveau l'étape 4. Les recettes créent souvent leur propre server.cfg, et l'onglet maintient la chaîne de connexion synchronisée avec celui-ci.

Pas de txAdmin sur FiveM Enhanced, ou avec txAdmin désactivé. Les serveurs FiveM Enhanced, et les serveurs FiveM où Enable / Disable TxAdmin sur Démarrage est défini sur 0, démarrent directement à partir de server.cfg et n'exécutent pas txAdmin. La dernière carte indique alors Your server starts straight from server.cfg. et n'a pas de bouton Open txAdmin. Seule l'étape 1 ci-dessus s'applique: ajoutez vos ressources dans le Gestionnaire de fichiers, listez-les dans server.cfg et redémarrez.

Gestion de la base de données

Ouvrez le serveur MariaDB à partir de votre liste de services et utilisez le Gestionnaire BD pour les tables, les requêtes, les importations et les exportations. Open Database Manager l'ouvre dans un nouvel onglet; le lien d'accès expire après 5 minutes. Pour déplacer une base de données d'un autre hôte, consultez Sauvegarder, importer et exporter une base de données.

Changer le mot de passe de la base de données

Si quelqu'un d'autre a vu le mot de passe, donnez un nouveau mot de passe à l'utilisateur de la base de données vous-même:

1. Démarrez le serveur de base de données s'il n'est pas en cours d'exécution. Le bouton ne fonctionne que lorsqu'il est en ligne.
2. Sur Configuration MySQL, cliquez sur Reset password sur la carte Database details.
3. Dans Reset database password?, cliquez sur Reset password. L'ancien mot de passe cesse de fonctionner immédiatement.
4. La fenêtre New password affiche le nouveau mot de passe une seule fois. Cliquez sur Copy et conservez-le en lieu sûr: pour votre sécurité, nous ne le montrons qu'ici et ne l'envoyons jamais par e-mail.
5. Cliquez sur Apply connection string (étape 4) pour que server.cfg obtienne le nouveau mot de passe, puis redémarrez votre serveur FiveM. Tant que vous ne le faites pas, le serveur continue d'essayer l'ancien mot de passe.

Mettez à jour toute autre application qui se connecte avec cet utilisateur de base de données également. Vous pouvez également le réinitialiser à partir du Gestionnaire BD sur le serveur MariaDB.

Problèmes courants

Pour la configuration générale de FiveM, consultez Démarrer avec GTA V: FiveM. Si quelque chose sur cette page ne correspond pas à ce que vous voyez, ouvrez un ticket de support et nous l'examinerons avec vous.