Migrer un serveur FiveM de Legacy vers Enhanced

Porter un serveur FiveM de Legacy vers Enhanced n'est pas une mise à jour d'artefact : le binaire serveur change, le runtime passe de Mono à .NET, et une partie de vos ressources doit être adaptée. Cette checklist déroule la migration ressource par ressource, dans l'ordre où les problèmes apparaissent réellement.

⚙️ Prérequis

• Un serveur Enhanced de test, distinct de votre production - voir lancer son serveur sur le build GTA V Enhanced
• Une sauvegarde complète de vos ressources et un dump de votre base MySQL
• La liste de vos scripts payants et de leurs boutiques d'origine
• Un accès console au serveur, pour lire les erreurs de chargement

⚙️ 1. Inventorier ses ressources

Avant toute chose, triez le contenu de votre dossier resources en quatre piles :

C'est cet inventaire qui décide si la migration est faisable maintenant ou non - pas la puissance du serveur.

⚙️ 2. Les scripts chiffrés : le point bloquant

L'Asset Escrow n'est pas implémenté sur Enhanced. Concrètement, une ressource protégée achetée sur Tebex ne se déchiffre pas et refuse de démarrer, quel que soit votre serveur.

Trois issues, dans l'ordre de préférence :

1. Demander au vendeur une version compatible Enhanced, ou une version ouverte pour les acheteurs existants
2. Remplacer le script par un équivalent open source, quand il en existe un
3. Attendre l'arrivée de l'escrow sur Enhanced, en gardant la production en Legacy

⚙️ 3. Lua : ce qu'il faut vraiment vérifier

Contrairement à ce qu'on lit souvent, il n'y a pas de lua54 à déclarer. La documentation Cfx.re est explicite : le réglage est déprécié et, depuis juin 2025, tous les scripts Lua tournent déjà en 5.4. Un manifeste standard suffit :

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'
server_script 'server.lua'

Le vrai travail est ailleurs : les scripts qui appellent des natives retirées sur Enhanced, ou qui manipulent des éléments graphiques du moteur, échouent au chargement ou en cours de partie. Ajoutez vos ressources une par une, console ouverte, et traitez les erreurs à mesure.

⚙️ 4. C# : recompiler pour .NET

Le runtime est passé de Mono à .NET. Une ressource C# compilée pour Legacy ne se charge pas sur Enhanced : il faut récupérer le projet source, mettre à jour la version cible du framework et les références Cfx.re, puis recompiler.

La recompilation demande le SDK .NET installé sur votre machine de développement. Si vous ne disposez pas des sources d'un script C# acheté, la situation est la même qu'avec l'escrow : seul l'auteur peut fournir une version compatible.

⚙️ 5. Frameworks : ESX, QBCore, QBox

Aucun des trois n'est plug-and-play sur Enhanced ; tous demandent une version portée. Avant de porter votre serveur, vérifiez l'état d'avancement du dépôt de votre framework et partez d'une installation propre du framework porté, dans laquelle vous réinjectez vos ressources maison - plutôt que de tenter de convertir une installation Legacy vieille de deux ans.

Si vous hésitez encore sur la base à reprendre, le comparatif ESX et QBCore reste valable : le choix de framework ne change pas avec Enhanced.

La connexion à la base de données, elle, ne bouge pas - voir connecter MySQL avec oxmysql.

⚙️ 6. Assets personnalisés

Véhicules add-on, MLO et vêtements doivent être convertis pour le moteur d'Enhanced : les fichiers pensés pour GTA V Legacy ne sont pas garantis de s'afficher correctement, et un asset non converti peut faire crasher le client des joueurs plutôt que de simplement ne pas apparaître.

Un point précis à ne pas manquer : une ressource qui diffuse ses fichiers depuis un dossier stream doit utiliser stream_enhanced sur Enhanced. C'est une étape mécanique, mais oubliée elle fait silencieusement disparaître vos assets.

Traitez-les en dernier, une fois le serveur stable avec vos scripts : un serveur qui démarre sans ses MLO reste jouable, l'inverse est faux.

⚙️ 7. Voix : Mumble est déprécié

Enhanced embarque un nouveau système de voix qui remplace Mumble, piloté par des natives côté serveur (CreateVoiceChannel, AddPlayerToVoiceChannel, SetPlayerMutedInVoiceChannel…). Les natives Mumble fonctionnent encore, en passant par ce nouveau système, mais elles sont dépréciées et seront retirées. Pour gagner du temps, setr sv_mumble true maintient la compatibilité Mumble le temps de porter votre ressource de voix. Testez-la avec plusieurs joueurs connectés simultanément, pas seul sur le serveur.

⚙️ 8. Tester en parallèle, basculer ensuite

La bonne séquence, dans l'ordre :

1. Instance Enhanced de test, serveur vide
2. Framework porté, sans aucune ressource maison
3. Ressources Lua maison, une par une, console ouverte
4. Ressources C# recompilées
5. Assets convertis
6. Test de charge avec de vrais joueurs
7. Bascule de la production, aux heures creuses

Chaque étape se valide dans la console : une ressource ajoutée, un redémarrage, zéro erreur. Ajouter dix ressources d'un coup, c'est perdre la trace de celle qui bloque le démarrage.

✅ Conclusion

La migration se joue sur un seul chiffre : le nombre de ressources chiffrées dont votre serveur ne peut pas se passer. Le reste - stream_enhanced, recompilation .NET, assets - est du travail mécanique qui se fait en parallèle de votre production. Reprenez le contexte technique dans FiveM Enhanced : lancer son serveur sur le build GTA V Enhanced.

Chez LordHosting, Legacy et Enhanced sont disponibles sur toutes les offres FiveM : vous pouvez garder votre serveur RP en production et monter une instance de portage sans changer de formule.