Convertir vos assets avec Alchemist

Vos assets 3D Legacy (Gen8) — véhicules, props, maps, MLO, vêtements — ne se chargeront pas tels quels sur FiveM Enhanced. Alchemist est l'outil officiel de Cfx.re qui les convertit vers le format Enhanced (Gen9). Cette page couvre ce qu'il convertit, GUI ou CLI, les flags, et la seule chose qui piège tout le monde : l'escrow.

Ce que fait Alchemist

Alchemist a deux fonctions :

Asset Conversion — convertir vos assets 3D Legacy vers le format Enhanced.
Asset Refinement — corriger les problèmes de formatage / compatibilité des assets Legacy créés par d'anciens outils.

Lorsque vous le pointez vers un dossier, il :

Trouve de manière récursive chaque asset Legacy dans tous les sous-dossiers.
Les convertit dans un répertoire de sortie / cible distinct.
Copie les fichiers non-asset environnants (vos scripts, UI, config) sans les modifier.

Pointez-le vers le répertoire resources de votre serveur et vous obtenez un dossier resources prêt à l'emploi, compatible avec FiveM Enhanced, dans le répertoire de sortie.

L'entrée et la sortie doivent être des dossiers différents. Vous sélectionnez votre dossier existant (Legacy) comme entrée ; Alchemist écrit la copie convertie dans un nouveau dossier de sortie. Vos originaux ne sont jamais modifiés.

Types de fichiers pris en charge

Alchemist convertit exactement cinq types de fichiers d'assets :

Extension	Type d'asset
YDR	Drawable (props, modèles statiques)
YTD	Dictionnaire de textures
YFT	Fragment (véhicules, objets destructibles)
YPT	Effet de particules
YDD	Dictionnaire de drawables (vêtements, modèles de composants)

Tout le reste (Lua, JS, XML, JSON, audio, fxmanifest.lua, etc.) est copié tel quel, sans modification.

Prérequis

Windows 11 est l'OS pris en charge officiellement.
Téléchargez Alchemist depuis le Cfx Portal (c'est un outil Cfx.re gratuit et officiel).

GUI ou CLI — choisissez selon l'escrow

Il existe deux versions, et la seule différence fonctionnelle qui compte est la façon dont elles gèrent les assets sous escrow (protégés par Tebex / chiffrés) :

	Alchemist (GUI)	AlchemistCli.exe (CLI)
Sélection	Boîtes de dialogue de navigation	Chemins de dossiers en arguments
Sur un asset sous escrow	Échoue et arrête tout le processus	L'ignore et le note dans le rapport
Batch / automatisation	—	Multi-thread, scriptable
Idéal pour	Petits dossiers non chiffrés	Tout ce qui contient des assets sous escrow

Aucune des deux versions ne peut déchiffrer l'escrow. Les assets protégés par escrow ne sont jamais convertis — la GUI s'arrête au premier, le CLI l'ignore et le signale. Le contenu protégé / payant reste sur Legacy tant que la prise en charge de l'Asset Escrow n'est pas disponible pour Enhanced. Seul le créateur original peut retirer l'escrow de son asset.

Utiliser la GUI

Lancez Alchemist.
Retirez d'abord tout asset sous escrow de l'arborescence d'entrée (sinon le processus s'arrêtera).
Sélectionnez votre dossier d'entrée (par ex. votre répertoire resources).
Sélectionnez un dossier de sortie / cible distinct.
Lancez la conversion et attendez qu'elle se termine.

Utiliser le CLI

Le CLI est recommandé pour les traitements par batch et pour toute arborescence contenant des assets sous escrow (il ne plantera pas dessus). Syntaxe :

AlchemistCli.exe [input_path] [output_path] [parameters]

Exemple de base :

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

Exemple avec flags (5 threads, écrasement, arrêt à la première erreur) :

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

Flags du CLI

Flag	Effet
`--refine`	Affiner les assets au lieu de les convertir (corriger les assets Legacy créés par d'anciens outils)
`--relaxed`	Mode assoupli — auto-corrections et vérifications moins strictes (peut altérer l'asset ; vérifiez en jeu)
`-f`	Écraser les fichiers de sortie sans confirmation
`-jN`	Nombre de threads (10 par défaut), par ex. `-j8`
`--fail-on-error`	S'arrêter à la première erreur

Workflow recommandé

Travaillez sur une copie de votre dossier resources.
Utilisez le CLI pour que les assets sous escrow soient ignorés plutôt que fatals.
Lisez le rapport de sortie — il liste ce qui a été ignoré (escrow) afin que vous sachiez ce qui reste sur Legacy.
Testez les assets convertis en jeu sur votre serveur de test Enhanced avant de déployer. Portez une attention particulière à tout ce qui a été converti avec --relaxed.

Dépannage

La GUI Alchemist s'arrête en plein milieu d'un dossier

Elle est tombée sur un asset sous escrow — la GUI échoue et s'arrête au premier. Retirez soit les assets sous escrow avant de lancer, soit passez à AlchemistCli.exe, qui les ignore automatiquement et les liste dans le rapport de sortie.

Un véhicule / prop converti a un rendu incorrect ou ne spawn pas

Essayez de le convertir sans --relaxed (le mode assoupli applique des auto-corrections qui peuvent altérer l'asset). Si cela échoue toujours, l'asset source a peut-être été créé avec un outil ancien / défectueux — essayez --refine pour corriger d'abord le formatage. Testez toujours les assets convertis en jeu.

Les modèles de mon script Tebex payant ne se sont pas convertis

C'est normal — ils sont protégés par escrow, et l'escrow ne peut pas être déchiffré par Alchemist. Gardez ces resources sur Legacy tant que l'Asset Escrow n'est pas disponible pour Enhanced, ou demandez au créateur s'il fournira un build compatible Enhanced.

Référence officielle complète : docs.fivem.net/docs/alchemist. Vous créez vos propres props ? Consultez notre workflow de création de props sur le Discord HZ-Scripts.