Configuration de txAdmin et recettes : déployer un serveur FiveM étape par étape

Vous avez téléchargé les artefacts du serveur FiveM, les avez démarrés, et maintenant txAdmin demande un PIN, un compte et un modèle. Ce guide vous guide à travers le premier démarrage, la liaison de votre compte Cfx.re, le choix d'une recette et ce qui se passe lors du deploy.

#Premier démarrage et le PIN

Sous Windows, exécutez FXServer.exe. Sous Linux, démarrez le run.sh à partir des artefacts. Le premier démarrage imprime une URL txAdmin et un PIN unique dans la console. Ouvrez l'URL dans votre navigateur et entrez le PIN. Seule la personne qui peut lire la console du serveur peut le faire, c'est le point.

Le PIN ne fonctionne qu'une seule fois. Si vous le perdez, arrêtez le serveur et redémarrez-le pour en obtenir un nouveau, tant que vous n'avez pas terminé la configuration du compte. Si vous l'avez déjà fait et avez oublié votre connexion, voir txAdmin forgot password.

#Lier votre compte Cfx.re

txAdmin vous demande de créer un compte principal. Vous le liez à votre compte Cfx.re, qui est le même compte que vous utilisez sur le forum FiveM et dans le Cfx.re Portal. Connectez-vous avec Cfx.re quand c'est demandé, puis choisissez un mot de passe de sauvegarde pour le compte afin de pouvoir toujours vous connecter si la connexion Cfx.re est en panne.

Gardez ce mot de passe quelque part de sûr. Vous ajouterez d'autres administrateurs plus tard à partir de la page d'administrateur txAdmin, chacun avec ses propres permissions.

#Nom du serveur et type de deploy

L'assistant de configuration demande un nom de serveur, puis le type de deploy. La formulation change entre les versions de txAdmin, mais vous verrez des choix le long de ces lignes :

• Recettes populaires : modèles prêts à l'emploi, y compris ESX Legacy, QBCore et QBox.
• Modèle d'URL distant : une recette que vous collez à partir d'un lien, par exemple une du référentiel propre d'un framework.
• Modèle local ou recette personnalisée : votre propre fichier de recette.
• Données serveur existantes : vous avez déjà un dossier de données serveur avec un server.cfg et vous voulez que txAdmin l'exécute.

Si c'est un nouveau serveur, choisissez une recette populaire. Les frameworks mettent à jour leurs recettes, donc vous obtenez une configuration actuelle sans chasser les liens de téléchargement.

#Choisir un modèle

Pas sûr ? Lisez install ESX Legacy, install QBCore et install QBox avant de choisir, car changer de frameworks plus tard signifie convertir vos données.

#Dossier et paramètres de recette

Après que vous avez choisi une recette, txAdmin affiche le dossier de données du serveur. C'est là où le deploy place server.cfg et le dossier resources. Gardez-le en dehors du dossier des artefacts, pour que vous puissiez mettre à jour les artefacts sans toucher à vos données (voir update FiveM server artifacts).

Ensuite vient un formulaire avec les paramètres de la recette. Champs typiques :

• Clé de licence Cfx.re : la clé dont votre serveur a besoin pour démarrer. Générez-la dans le Cfx.re Portal. Si vous obtenez une erreur à ce sujet, lisez the server license key error.
• Paramètres de base de données : hôte, utilisateur, mot de passe et nom de la base de données.
• Nombre maximum de joueurs, nom du serveur et autres options que la recette offre.

Attention : la clé de licence est privée. Ne postez pas server.cfg dans les captures d'écran ou les messages Discord sans la cacher.

#Identifiants de base de données pendant le deploy

Les frameworks stockent les joueurs, l'argent, les véhicules et bien d'autres dans une base de données MySQL ou MariaDB. La recette doit se connecter pour créer ses tables. Vous avez généralement deux configurations :

1. Un serveur de base de données que vous exécutez déjà (une MariaDB locale, XAMPP, ou une de votre hôte). Entrez son hôte, utilisateur et mot de passe. L'utilisateur a besoin de permission pour créer une base de données.
2. Les valeurs de formulaire par défaut txAdmin, qui conviennent à une configuration locale où la base de données s'exécute sur la même machine.

Le deploy construit la chaîne de connexion pour vous, donc vous n'avez pas besoin de l'écrire à la main. Dans server.cfg, vous la trouverez comme :

set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

Si le serveur dit plus tard qu'il ne peut pas se connecter, la correction est dans oxmysql connection error.

#Ce que la recette fait vraiment

Une recette est une liste de tâches que txAdmin exécute dans l'ordre. En termes simples :

1. Télécharge les ressources : le framework, ses ressources, oxmysql et d'autres dépendances, généralement sous forme de fichiers ZIP depuis GitHub.
2. Décompresse et déplace les ressources dans le dossier resources.
3. Crée la base de données et importe le fichier SQL du framework, en utilisant les identifiants que vous avez entrés.
4. Écrit server.cfg : le nom de votre serveur, la clé de licence, la chaîne de connexion, les lignes ensure et les permissions.

Quand le deploy se termine, txAdmin affiche le server.cfg généré pour examen. C'est le bon moment pour le lire ligne par ligne : voir server.cfg explained. Vous pouvez l'éditer, puis l'enregistrer et démarrer le serveur.

#Après le deploy

Démarrez le serveur à partir du tableau de bord txAdmin et regardez la console. Un démarrage sain se termine avec les ressources listées comme démarrées et aucune erreur rouge. Ensuite, connectez-vous avec FiveM et vérifiez que vous atteignez l'écran de caractère ou le spawn.

Si une ressource échoue, couldn't start resource et reading a script error couvrent ce que les messages signifient. Pour vos propres droits d'administrateur en jeu, voir ACE permissions.

Conseil : faites une copie du dossier de données du serveur et une export de la base de données juste après un deploy propre. Si vous cassez quelque chose en expérimentant, vous pouvez revenir à un état connu bon. Le backup guide montre comment.

#Liste de contrôle