Comment configurer un serveur FiveM Enhanced (GTA V)

FiveM Enhanced est la version en accès anticipé de FiveM proposée par Cfx.re pour GTA V Enhanced, la nouvelle édition PC du jeu, et ce guide accompagne un serveur FiveM Enhanced neuf chez DoomHosting depuis son premier démarrage jusqu'à une configuration fonctionnelle. Choisissez Enhanced si votre communauté joue déjà à GTA V Enhanced et que vos scripts sont open source. Restez sur FiveM Legacy si vous dépendez de ressources protégées par escrow ou de joueurs qui possèdent l'ancienne édition, car les deux versions ne partagent jamais leurs joueurs.

Enhanced ou Legacy : laquelle choisir ?

Enhanced et Legacy sont deux produits distincts, avec des clients et des logiciels serveur séparés. Un serveur Enhanced n'accepte que les joueurs qui utilisent le client FiveM for GTAV Enhanced, et un serveur Legacy uniquement le client classique. Avant de vous décider, pesez ces limites de l'accès anticipé :

Pas encore d'Asset Escrow. Les ressources chiffrées achetées via Tebex ne se chargent pas sur Enhanced. Les ressources open source fonctionnent normalement.
OneSync est toujours actif, en mode big, et la synchronisation client-serveur remplace l'ancien modèle pair à pair.
Le mode pure est toujours actif, donc les mods graphiques sont inutilisables pendant l'accès anticipé.
Seul le dernier gamebuild est pris en charge.

Si cela convient à votre projet, commandez un serveur FiveM Enhanced. Il coûte le même prix que Legacy, et tout ce qui suit se fait dans notre panel de jeu.

Premier démarrage : ajouter votre clé de licence

Enhanced demande la même clé de licence Cfx.re gratuite que Legacy. Si vous n'en avez pas encore, notre guide de la clé de licence explique comment la créer sur portal.cfx.re.

Cliquez sur Start sur votre nouveau serveur. Comme aucune clé n'est encore enregistrée, une fenêtre intitulée Add your FiveM license key s'affiche. Collez la clé (elle commence par cfxk_ et compte 33 caractères), puis cliquez sur Save and start. Le panel l'enregistre et démarre le serveur en une seule étape.

La fenêtre Add your FiveM license key qui s'ouvre quand on démarre un serveur FiveM Enhanced sans clé

Réglages de l'onglet Startup

L'onglet Startup contient les valeurs que le serveur lit au démarrage :

fivem license : la clé que vous venez d'enregistrer. Remplacez-la ici si vous la régénérez un jour.
Max Players : le nombre de places proposées sur le serveur.
Server Hostname : le nom affiché dans la liste des serveurs FiveM.
Steam Web Api Key : laissez none sauf si l'une de vos ressources recherche des joueurs sur Steam.
Enable txadmin : active ou désactive txAdmin.
txAdmin Port : en lecture seule. Le panel attribue automatiquement ce second port pour l'interface web de txAdmin.

Les modifications de cet onglet s'appliquent au prochain redémarrage.

L'onglet Startup d'un serveur FiveM Enhanced avec les champs licence, Max Players, Server Hostname, Steam Web Api Key et txAdmin

txAdmin activé ou désactivé

Par défaut, le serveur démarre directement depuis server.cfg. Cliquez sur Enable txAdmin dans l'en-tête (ou utilisez l'interrupteur de l'onglet Startup), redémarrez, et c'est txAdmin qui prend la main : server.cfg n'est plus exécuté et les réglages se gèrent dans l'interface web de txAdmin. Le PIN de première utilisation, les recettes et les redémarrages planifiés fonctionnent comme sur Legacy, donc suivez notre guide txAdmin pour ces points.

L'onglet Network affiche les deux ports. Le premier est le port de jeu auquel les joueurs se connectent ; celui qui porte le badge txAdmin sert à l'interface web.

L'onglet Network listant le port de jeu et le port txAdmin d'un serveur FiveM Enhanced

L'onglet Config et server.cfg

Tant que txAdmin est désactivé, l'onglet Config permet de modifier la fiche du serveur sans ouvrir de fichier : Project name, Project description, Tags, Locale et Allow ScriptHook. Le nom du serveur et le nombre de places n'y figurent pas, volontairement. Les deux viennent de Startup et sont réécrits dans server.cfg à chaque démarrage, donc une modification manuelle serait écrasée.

L'onglet Config d'un serveur FiveM Enhanced avec Project name, Project description, Tags, Locale et Allow ScriptHook

Tous les autres réglages se trouvent dans server.cfg, à la racine du serveur, que vous ouvrez depuis l'onglet Files. Le gestionnaire de fichiers affiche aussi le dossier alpine, qui contient le binaire cfx-server (l'équivalent Legacy est FXServer), et resources, où vont vos scripts et vos maps.

La racine du gestionnaire de fichiers d'un serveur FiveM Enhanced avec les dossiers alpine et resources et le fichier server.cfg

Les scripts qui stockent des données ont besoin d'une base MySQL. Créez-en une dans l'onglet Databases et reliez-la comme décrit dans notre guide des bases de données ; rien ne change sur Enhanced.

Migrer des ressources depuis Legacy

La plupart des scripts open source fonctionnent tels quels, mais plusieurs changements d'Enhanced piègent les anciennes installations. Passez cette liste en revue avant de copier un serveur Legacy :

Les ressources sous escrow restent bloquées tant que Cfx.re n'a pas livré Asset Escrow pour Enhanced. Demandez à l'auteur une version non chiffrée, ou gardez ce projet sur Legacy.
Les assets streamés (véhicules, maps, vêtements) doivent être convertis avec l'outil Alchemist de Cfx.re. Placez les fichiers convertis dans un dossier stream_enhanced à côté du dossier stream existant. Enhanced charge stream_enhanced à la place de stream, donc une même ressource peut servir les deux versions.
Les données KVP doivent être migrées avec kvdb-migrator, sinon les données clé-valeur enregistrées apparaissent vides.
Les ID serveur des joueurs sont réattribués dès qu'un joueur se déconnecte. Tout script qui mémorise des ID pour distinguer les joueurs doit être vérifié.
Les callbacks NUI s'exécutent par défaut en mode strict. Une ressource qui casse à cause de cela peut s'y soustraire dans son fxmanifest.lua :

nui_callback_strict_mode 'false'

Les ressources C# tournent désormais sur .NET 10 au lieu de Mono, donc testez-les avant la mise en ligne.
Endpoints : endpoint_add_tcp et endpoint_add_udp n'acceptent chacun qu'un seul endpoint.
Le mode dev exige sv_devMode true dans server.cfg.
Jeu de base sans DLC : définissez sv_enforceGameBuild 1.

Mettre à jour le serveur

Cfx.re ne publie qu'une seule version Enhanced courante, il n'y a donc pas de sélecteur de build comme sur les serveurs Legacy. Pour obtenir la dernière version, ouvrez l'onglet Settings et cliquez sur Reinstall server : la réinstallation retélécharge le logiciel serveur et conserve vos fichiers (resources, server.cfg, txData) tant que vous laissez la case de wipe décochée. Une sauvegarde préalable dans l'onglet Backups reste une bonne idée.

Problèmes courants

Command not found (sv_endpointprivacy) : cette commande n'existe pas sur Enhanced. Supprimez la ligne de server.cfg et redémarrez.

Une ressource sous escrow ne se charge pas : Asset Escrow n'est pas encore disponible sur Enhanced. Remplacez-la par une alternative open source ou exécutez-la sur un serveur Legacy.

Des joueurs Legacy ne peuvent pas se connecter : un joueur sur FiveM classique ne pourra jamais rejoindre un serveur Enhanced. Il lui faut GTA V Enhanced et le client FiveM for GTAV Enhanced, comme expliqué dans comment rejoindre un serveur FiveM Enhanced.

"A valid license check is required to run this server" : la clé enregistrée est vide, mal saisie ou invalide. Ouvrez Startup, collez la clé dans fivem license sans espace autour, puis relancez le serveur.

Les modifications de server.cfg ne changent rien : txAdmin est activé et il n'exécute pas server.cfg. Faites la modification dans txAdmin, ou désactivez txAdmin et redémarrez.