Créer un serveur FiveM avec txAdmin : guide

Ce guide explique comment configurer un serveur FiveM pour GTA V Legacy avec FXServer et txAdmin, sous Windows ou Linux. Vous allez créer une clé d'enregistrement dans Cfx.re Portal, déployer la recette par défaut, vérifier la configuration et tester une connexion. Ajoutez un framework roleplay une fois que le serveur de base fonctionne.

Avant de commencer

Prérequis	Préparation
Compte Cfx.re	Utilisez ce compte pour enregistrer le serveur dans Portal et l'associer à txAdmin.
Une machine pour le serveur	Un PC local pour apprendre, ou un hébergement prenant en charge FXServer. Vérifiez l'accès aux fichiers, à la console, au pare-feu et aux sauvegardes avant de choisir une offre.
Un client pour jouer	Pour rejoindre ce serveur Legacy, utilisez une installation légitime de GTA V Legacy et le client FiveM correspondant. GTA V n'a pas besoin d'être installé sur la machine qui héberge le serveur.
Outils Windows	Un logiciel capable d'extraire les fichiers `.7z`, comme 7-Zip.
Outils Linux	Un compte non-root pour exécuter FXServer, un outil de téléchargement et la prise en charge des archives `.tar.xz`. Les commandes de gestion des paquets ci-dessous concernent Debian/Ubuntu.

La RAM et les caractéristiques du processeur ne suffisent pas à garantir un nombre de joueurs. Le code des ressources, les contenus diffusés aux clients, la base de données et les activités simultanées influencent les besoins. Commencez avec une petite configuration de test et mesurez sa charge avant de payer pour davantage de capacité.

Choisir entre Legacy et Enhanced

Les commandes ci-dessous concernent GTA V Legacy et FXServer. À la date de vérification des sources indiquée plus bas, Cfx.re présente FiveM for GTAV Enhanced comme une version en accès anticipé. Enhanced utilise des fichiers Cfx Server distincts, dont cfx-server.exe sous Windows, et comporte des changements pouvant nécessiter des adaptations des ressources ou de la configuration.

Pour Enhanced, lisez les notes officielles de migration et de rupture de compatibilité avant de choisir un framework ou de déplacer un serveur. Vérifiez la prise en charge des assets, de la communication vocale et d'Asset Escrow dans la version actuelle. Notre comparaison de Legacy et Enhanced explique ce choix ; renommer un exécutable ne constitue pas une migration.

Étape 1 : créer une clé d'enregistrement

Ouvrez la page Server registration keys de Cfx.re Portal et connectez-vous.
Choisissez l'option de génération d'une clé, saisissez un nom d'affichage et confirmez.
Copiez la clé générée pour le Recipe Deployer de txAdmin. Dans server.cfg, le paramètre correspondant est sv_licenseKey.

Les instructions actuelles de Cfx.re demandent un nom d'affichage, pas l'IP publique du premier démarrage évoquée dans les anciens tutoriels Keymaster. Ne placez pas la clé dans un dépôt public, une capture d'écran ou des journaux partagés. Si elle est divulguée, régénérez-la dans Portal et mettez à jour la configuration du serveur.

Étape 2 : télécharger les fichiers du serveur Legacy

Ouvrez la page officielle Server Download, sélectionnez FiveM pour GTA V Legacy et votre système d'exploitation, puis téléchargez la version recommandée. Copiez l'URL de téléchargement actuelle depuis cette page plutôt que de reprendre un numéro de version trouvé dans un tutoriel.

Windows

Créez le dossier C:\FXServer\server pour les fichiers du serveur.
Téléchargez server.7z et extrayez son contenu dans ce dossier.

Linux : préparation sous Debian/Ubuntu

Installez les outils de téléchargement et d'extraction avec un compte autorisé à gérer les paquets. Exécutez FXServer lui-même avec votre utilisateur dédié, sans droits root.

sudo apt update
sudo apt install ca-certificates wget xz-utils
mkdir -p ~/FXServer/server
cd ~/FXServer/server
wget -O fx.tar.xz 'PASTE_RECOMMENDED_LINUX_URL_HERE'
tar -xf fx.tar.xz

Remplacez PASTE_RECOMMENDED_LINUX_URL_HERE avant de lancer le téléchargement. Résolvez toute erreur de téléchargement ou d'extraction avant de continuer. Pour les autres distributions, utilisez leur gestionnaire de paquets et consultez les prérequis Linux officiels.

Étape 3 : démarrer FXServer et accéder à txAdmin

txAdmin est inclus dans les versions actuelles de FXServer. Lancez FXServer sans +exec server.cfg : txAdmin gérera la configuration du serveur au cours de son assistant d'installation.

Windows : exécutez FXServer.exe dans le dossier extrait.
Linux : exécutez bash ~/FXServer/server/run.sh.

La console affiche l'URL de configuration et le code PIN. Le port web par défaut de txAdmin est 40120 TCP. Sur la machine du serveur, ouvrez http://127.0.0.1:40120. Un hébergeur peut fournir une autre URL ou un autre port.

Pour un serveur distant accessible en SSH, vous pouvez ouvrir ce tunnel depuis votre propre ordinateur, le laisser actif, puis consulter cette même URL locale :

ssh -N -L 127.0.0.1:40120:127.0.0.1:40120 user@YOUR_SERVER_IP

Remplacez le nom d'utilisateur SSH et l'adresse du serveur. Limitez l'accès direct au port d'administration avec les contrôles d'accès ou le pare-feu de votre hébergement ; un tunnel ne ferme pas à lui seul un port exposé publiquement. Les joueurs n'ont pas besoin d'accéder à txAdmin pour rejoindre le serveur.

Étape 4 : associer votre compte et déployer la recette par défaut

Saisissez le PIN de la console si nécessaire, puis sélectionnez Link Account.
Autorisez l'association du compte Cfx.re, choisissez un mot de passe de secours solide et lisez les accords présentés par txAdmin.
Saisissez un nom de serveur et choisissez Popular Recipes.
Sélectionnez la recette FiveM par défaut de Cfx.re. Selon la version de l'interface, elle peut s'appeler FiveM Basic Server (CFX Default) ou CFX Default FiveM.
Confirmez un dossier de données distinct pour les ressources et server.cfg, puis ouvrez Recipe Deployer.
Vérifiez la recette, saisissez votre clé d'enregistrement et sélectionnez Run Recipe.
Attendez que toutes les tâches se terminent sans erreur, vérifiez la configuration générée et sélectionnez Save & Run Server.

La recette par défaut fournit un serveur de base, sans économie roleplay complète. Elle permet de vérifier le serveur avant d'ajouter les dépendances d'un framework et d'une base de données. Si le déploiement échoue, conservez la première erreur pertinente de la console et résolvez-la avant de réessayer.

Créez un compte distinct pour chaque membre de l'équipe dans l'Admin Manager de txAdmin. Accordez uniquement les actions nécessaires : consulter la console, exécuter des commandes, modifier la configuration et gérer les autres administrateurs sont des permissions séparées. Les rôles du framework et les règles ACE du serveur se configurent séparément.

Étape 5 : vérifier server.cfg

Modifiez les valeurs déjà présentes dans la configuration générée par la recette. Conservez les lignes de démarrage des ressources. Cet extrait illustre un petit serveur de test ; il ne remplace pas le fichier complet :

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "My Legacy test server"
sets sv_projectName "My Legacy test server"
sets sv_projectDesc "A basic server for connection testing"
sets tags "test"

sv_maxclients 8
set onesync on
sv_licenseKey "REPLACE_WITH_YOUR_KEY"

Paramètre	Vérification
`endpoint_add_tcp` et `endpoint_add_udp`	Utilisez le port attribué par votre hébergeur. Les exemples emploient 30120 pour les deux protocoles ; les règles du pare-feu et les commandes de connexion doivent correspondre.
`sv_maxclients`	Définit la limite de joueurs, sans garantir les performances. Une limite plus élevée peut nécessiter un abonnement Cfx.re ; vérifiez vos droits actuels dans Portal.
`sv_projectName` et `sv_projectDesc`	Renseignez des valeurs utiles pour la liste des serveurs.
`sv_enforceGameBuild`	N'imposez une version du jeu qu'après avoir vérifié les exigences des ressources et les versions prises en charge par votre branche du serveur.

Le guide de server.cfg détaille la configuration. Vous pouvez également consulter le générateur de server.cfg et les autres outils pour serveur ; vérifiez les valeurs générées par rapport à votre recette et à votre hébergement.

Étape 6 : configurer l'accès des joueurs

Pour accueillir des joueurs sur d'autres machines, autorisez le port de jeu configuré dans le pare-feu du système et dans celui de l'hébergeur, le cas échéant. Les exemples utilisent 30120 TCP et UDP. Gardez le port distinct de txAdmin réservé aux administrateurs.

Pare-feu Windows : PowerShell en administrateur

New-NetFirewallRule -DisplayName "FiveM TCP" -Direction Inbound -Protocol TCP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "FiveM UDP" -Direction Inbound -Protocol UDP -LocalPort 30120 -Action Allow

Linux : si UFW est déjà utilisé

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw status

Vérifiez les règles obtenues et préservez l'accès utilisé pour administrer la machine. Ces commandes ne configurent ni un pare-feu en amont ni un routeur.

Si vous hébergez derrière un routeur domestique, redirigez le port de jeu pour les deux protocoles vers l'adresse locale du PC serveur. Vérifiez que votre connexion permet le trafic public entrant. Un serveur public hébergé à domicile expose l'adresse publique de votre connexion ; tenez-en compte lors du choix de l'hébergement.

Étape 7 : vérifier les connexions locales et externes

Ouvrez le client FiveM pour Legacy, appuyez sur F8 et utilisez l'adresse adaptée à votre test. Remplacez les libellés d'adresse et le port si nécessaire.

Test	Commande dans le client
Client et serveur sur le même PC	`connect 127.0.0.1:30120`
Un autre PC sur le même réseau local	`connect SERVER_LAN_IP:30120`
Un joueur extérieur à votre réseau	`connect SERVER_PUBLIC_IP:30120`

Rejoignez le monde, déplacez-vous, déconnectez-vous puis reconnectez-vous en surveillant la console du serveur. Pour un serveur public, faites tester la connexion depuis un autre réseau : une connexion locale réussie ne prouve pas l'accessibilité publique.

Vous pouvez aussi consulter http://SERVER_PUBLIC_IP:30120/info.json depuis l'extérieur du réseau du serveur. Une réponse JSON vérifie le point d'accès HTTP ; elle ne confirme ni le trafic UDP ni le bon déroulement de toute la connexion au jeu. Conservez le test avec un client externe.

Une fois ces vérifications réussies, sauvegardez de manière sécurisée le dossier de données fonctionnel et la configuration de txAdmin avant toute nouvelle modification.

Étape 8 : choisir un framework roleplay

Choisissez selon les ressources prévues et les interfaces que votre équipe peut maintenir. Comparez les options dans notre guide des frameworks FiveM.

Framework	Compatibilité à vérifier
QBCore	Vérifiez que vos ressources prennent en charge les API et les dépendances de la version QBCore installée.
Qbox	Sa passerelle QBCore couvre de nombreuses ressources utilisant les interfaces documentées. Les scripts qui accèdent directement aux tables ou fichiers internes peuvent nécessiter des adaptations. Le guide d'installation exige MariaDB et ne prend en charge ni MySQL ni XAMPP.
ESX Legacy	Utilisez des ressources compatibles ESX et suivez les instructions actuelles pour la recette et la base de données.

Lisez le guide d'installation actuel du framework avant le déploiement. Utilisez un nouveau dossier de données et une base de test vide pour la recette. Créez un compte de base de données dédié à l'application, gardez les identifiants confidentiels et vérifiez la création des personnages ainsi que la persistance des données avant d'ajouter d'autres ressources.

Étape 9 : ajouter et maintenir des ressources

Vérifiez la provenance de chaque ressource, sa compatibilité avec votre branche du serveur, ses exigences de framework et ses dépendances.
Placez-la dans le dossier resources/ de la recette, par exemple resources/[local]/example_resource. Examinez le fxmanifest.lua fourni et les instructions d'installation.
Ajoutez ensure example_resource après ses dépendances dans server.cfg.
Testez un ajout à la fois et lisez la première erreur au démarrage ou en jeu. Pour les véhicules, consultez le guide d'installation de voitures personnalisées.

Pour vos scripts de gameplay, validez les actions sensibles sur le serveur à partir des permissions et de l'état connus côté serveur. Des vérifications uniquement côté client ne suffisent pas à protéger l'attribution d'objets, les paiements ou les actions privilégiées.

Sauvegardez les ressources, la configuration et toute base de données, puis testez une restauration. Lisez les notes de version et essayez les mises à jour sur une copie distincte avant de remplacer une installation fonctionnelle. Appuyez-vous sur les journaux et les mesures pour rechercher les problèmes ; des redémarrages programmés n'en corrigent pas la cause.

Dépannage

Symptôme	Vérification suivante
`no license key was specified`	Vérifiez `sv_licenseKey` dans la configuration réellement chargée par txAdmin. Pour un lancement manuel, vérifiez aussi le dossier de données et `+exec server.cfg` ; n'ajoutez pas cet argument à la commande de démarrage de txAdmin.
`Failed to start resource`	Lisez l'erreur précédente. Vérifiez le dossier de la ressource, son manifeste, ses dépendances et l'ordre de démarrage ; le message seul ne désigne pas une cause unique.
Connexion expirée ou refusée	Confirmez que FXServer fonctionne, puis vérifiez l'adresse choisie, les deux protocoles du port de jeu, le pare-feu de la machine et les règles du routeur ou de l'hébergeur.
Connexion directe possible, mais serveur absent de la liste	Laissez le temps à la liste de se mettre à jour. Vérifiez `sv_projectName`, `sv_projectDesc` et toute directive `sv_master1 ""` à l'aide des instructions Cfx.re sur la liste des serveurs.
txAdmin inaccessible	Vérifiez l'URL et le port affichés dans la console, le processus et vos règles d'accès administrateur. Dans un navigateur, `127.0.0.1` désigne l'ordinateur sur lequel il s'exécute, sauf si vous avez configuré le tunnel ci-dessus.
FXServer ne répond plus	Examinez les journaux autour du premier échec, les dernières modifications de ressources et l'utilisation du processeur, de la mémoire et du stockage. Conservez ces éléments avant de redémarrer.

Pour poursuivre le diagnostic, consultez le guide des erreurs FiveM et la documentation officielle sur les problèmes serveur ci-dessous.

Questions fréquentes

Faut-il un framework payant ou un pack serveur ?

Une installation de base de FXServer ne nécessite pas de framework payant. Prévoyez séparément l'hébergement, les éventuelles ressources sous licence et les abonnements Cfx.re nécessaires aux fonctions choisies. Si vous souhaitez monétiser le serveur, lisez les instructions Cfx.re sur Tebex et les politiques associées avant de concevoir vos offres.

Faut-il choisir Windows ou Linux ?

Choisissez un système pris en charge par votre hébergeur et que votre équipe sait administrer. Ce guide présente les deux démarrages Legacy ; l'installation des paquets, la gestion des services et le dépannage diffèrent selon le système.

Combien de temps prend la configuration ?

La durée dépend des téléchargements, de l'accès au compte, du réseau et des dépendances de la recette. La réussite des tests de connexion constitue la première étape. La configuration du framework, l'intégration des ressources et une procédure de restauration testée restent à préparer avant l'ouverture au public.

Sources

Vérification des sources techniques : 10 octobre 2026. Cet article a été vérifié à partir de la documentation liée ; les commandes n'ont pas été exécutées sur un serveur de test pour cette vérification.