Convertir ses assets Legacy vers Enhanced sur FiveM avec Alchemist

Quand on migre un serveur de FiveM Legacy vers Enhanced, on s’inquiète d’abord des scripts. C’est rarement là que ça coince. Le vrai chantier, ce sont les assets 3D : véhicules add-on, MLO, vêtements, props — tout ce qui a été construit pour la génération Gen8 de GTA V et que la génération Gen9 ne lit pas tel quel.

Cfx.re publie un outil officiel exactement pour ça : Alchemist. Voici comment il marche, ce qu’il couvre, et ce qu’il ne couvre pas.

Le problème, en une ligne

GTA V Legacy (Gen8) et GTA V Enhanced (Gen9) ne stockent pas leurs ressources 3D dans le même format. Un modèle qui fonctionne parfaitement sur ton serveur Legacy depuis trois ans n’est pas lisible par le client Enhanced. Multiplié par les centaines de fichiers d’un serveur mature, la conversion à la main n’est simplement pas envisageable.

Si tu hésites encore sur la version à viser, commence par notre comparatif Legacy ou Enhanced.

Alchemist, c’est quoi ?

Alchemist est l’utilitaire de conversion officiel de Cfx.re, destiné aux joueurs, aux gérants de serveur et aux créateurs d’assets. Il se télécharge depuis le Cfx Portal et tourne sous Windows 11 uniquement — c’est sa contrainte la plus bête, et celle qui bloque le plus de monde.

Il propose deux modes :

Asset Conversion — convertit un dossier et tout son contenu pour rendre tes assets Legacy compatibles avec FiveM Enhanced. C’est le mode de la migration.
Asset Refinement — corrige des assets Legacy qui restent en Legacy, typiquement ceux produits par de vieux outils et qui traînent des défauts de format. C’est le mode « réparation », utile même si tu ne migres pas.

Les formats pris en charge

Alchemist traite cinq extensions :

Extension	Contenu
`.ydr`	Modèle (drawable)
`.ydd`	Dictionnaire de modèles
`.yft`	Modèle fragmenté (véhicules, objets cassables)
`.ytd`	Dictionnaire de textures
`.ypt`	Effets de particules

C’est l’essentiel du poids d’un serveur : véhicules, vêtements, props, textures. Mais retiens la contrepartie — ce qui n’est pas dans cette liste ne passe pas par Alchemist. Les .ymap, .ytyp, .ybn (collisions), .ycd (animations) ne sont pas de son ressort. Sur un MLO complexe, l’outil traitera les modèles et les textures, pas la totalité du paquet. Prévois du test.

Méthode 1 : l’interface graphique

La plus simple pour un premier passage.

Lance Alchemist.exe (double-clic).
Accepte ou refuse l’envoi de données de télémétrie.
Choisis le mode : Asset Conversion ou Asset Refinement.
Browse → sélectionne le dossier d’entrée.
Browse → sélectionne le dossier de sortie.
Lance, et laisse tourner.

Le résultat atterrit dans le dossier de sortie. Point important : si tu passes le dossier resources de ton serveur en entrée, tu récupères en sortie un dossier de remplacement prêt à poser tel quel pour FiveM Enhanced.

Méthode 2 : la ligne de commande

Plus rapide, scriptable, et — on le verra — plus robuste.

Ouvre une invite de commandes.
Glisse AlchemistCli.exe dans la fenêtre, puis Entrée.
Accepte les conditions d’utilisation (y).
Réponds pour la télémétrie (y ou n).

La syntaxe de base est simplement entrée puis sortie :

C:\AlchemistCli.exe C:\input C:\output

Les paramètres disponibles :

Paramètre	Effet
`--refine`	Affine les assets au lieu de les convertir
`--relaxed`	Mode permissif : validation allégée + corrections automatiques
`-f`	Écrase les fichiers existants sans demander
`-jN`	Nombre de threads (10 par défaut) — ex. `-j8`
`--fail-on-error`	Arrête tout à la première erreur

Un exemple complet :

C:\AlchemistCli.exe C:\input C:\output -j5 -f --fail-on-error

--fail-on-error est ton allié pour un premier passage de diagnostic : tu veux savoir quel asset pose problème, pas récupérer 400 fichiers convertis et un trou au milieu. Une fois les cas tordus identifiés et écartés, relance sans le drapeau pour traiter le lot.

Le piège : les assets escrow

C’est la limitation à connaître avant de perdre une soirée. L’interface graphique échoue sur les assets protégés par l’escrow : le processus plante, tout simplement.

Deux issues :

retirer les assets escrow du dossier avant de lancer la GUI ;
utiliser la CLI, qui les ignore automatiquement.

À elle seule, cette différence justifie de faire ses conversions en ligne de commande sur un serveur réel.

Et il faut enchaîner sur la conséquence stratégique : l’Asset Escrow n’est pas encore disponible sur Enhanced en accès anticipé. Tes ressources payantes protégées ne sont donc pas juste « difficiles à convertir » — elles n’ont, pour l’instant, pas de destination. Si ton serveur repose dessus, la migration n’est pas un problème d’outillage mais de calendrier : il faut attendre.

Le mode relaxed, avec modération

--relaxed (ou l’option équivalente dans la GUI) importe des assets qui ne respectent pas strictement les règles de validation : certaines vérifications sont sautées pour maximiser la compatibilité. En échange, l’outil applique des corrections automatiques — donc ton asset peut être légèrement modifié.

La bonne pratique : passage normal d’abord, --relaxed seulement sur les fichiers qui ont refusé de passer, et contrôle visuel en jeu derrière. Ce n’est pas un drapeau à mettre par défaut « au cas où ».

La méthode qui évite les regrets

Travaille sur une copie. Entrée et sortie sont deux dossiers distincts, mais garde de toute façon tes originaux Legacy intacts — c’est ta seule marche arrière.
Convertis par lots, pas tout le serveur d’un coup. Les véhicules d’abord, puis les vêtements, puis les MLO : quand quelque chose casse, tu sais quoi regarder.
Teste en jeu, pas seulement l’absence d’erreur en console. Un .ytd converti peut se charger sans broncher et afficher une texture noire.
Vérifie les collisions et le placement des MLO et des props : ce sont justement les formats qu’Alchemist ne traite pas.
Note ce que tu as passé en relaxed — ce sont tes premiers suspects au moindre bug d’affichage.

Convertir, ou repartir propre ?

Il y a un cas où toute cette procédure ne s’applique pas : le serveur standalone, écrit pour Enhanced dès le départ, sans dette d’assets Gen8. Zéro conversion, zéro escrow, zéro surprise de format.

C’est le choix qu’on a fait pour Chased : une resource unique, standalone, pensée pour Enhanced, avec des duels 1v1 chasseur contre chassé en voiture commune tirée au sort. Rien à migrer, parce qu’il n’y a rien à traîner.

Pour la suite, vois notre page FiveM Enhanced et, si tu pars de zéro, installer FiveM pour GTA 5 Enhanced.