Passer de XML à YMAP exige une conversion propre au format, pas un changement de nom. Une sauvegarde de placements Menyoo, une sauvegarde Map Editor de Guadmaz et un YMAP XML CodeWalker peuvent tous se terminer par .xml, mais décrivent des structures différentes. Identifiez l’outil d’origine avant de choisir un importateur.
Ce guide concerne les placements statiques d’objets. Il ne promet pas de conserver scripts, entités mobiles, peds, pickups, objets attachés ou intérieur MLO complet. Conservez l’original et travaillez sur une copie. Un placement converti ne fournit pas des modèles, textures ou collisions personnalisés jamais inclus.
Identifiez votre format XML
Ouvrez une copie dans un éditeur de texte brut sans rien exécuter. Vérifiez l’élément racine et l’application d’origine ; ne déduisez pas le format de la seule extension.
| Entrée | Ce que cela représente | Prochaine étape adaptée |
|---|---|---|
XML CodeWalker avec l’élément racine CMapData à la racine |
Une représentation textuelle des données YMAP | Utilisez le flux compatible d’import et de compilation XML de CodeWalker |
| XML de placements Menyoo | Une scène Object Spooner enregistrée | Utilisez un importateur prenant explicitement en charge ce format Menyoo |
| XML Map Editor de Guadmaz | Le schéma de sauvegarde de cartes de cet éditeur | Utilisez un convertisseur prenant explicitement en charge le XML Map Editor |
Natif .ymap |
Données de carte compilées, pas du XML texte | Ouvrez-le comme fichier du jeu plutôt que de le renommer en XML |
| Un JSON de projet Map Studio | Le projet de planification modifiable de ce site | Ouvrez dans Map Studio, puis exportez les sources prises en charge |
L’importateur du navigateur accepte le XML CodeWalker pris en charge CMapData XML, pas n’importe quel XML Menyoo ou Map Editor. Il refuse aussi les cartes avec liens parents plutôt que de présenter une modification partielle comme un aller-retour complet sûr. Le guide des formats de fichiers explique la distinction entre format natif et sources.
Préparez un petit candidat à convertir
Enregistrez une scène de trois objets statiques dont les noms existent dans votre installation. Notez nom, position, rotation et échelle. Évitez les dépendances à un autre mod pour ce premier test. Listez les fonctions volontairement exclues : une perte silencieuse n’est pas une conversion réussie.
Enregistrez la source sous un nouveau nom. Une scène de centaines de placements est un mauvais premier diagnostic : dépendance manquante, transformation erronée et entité non prise en charge peuvent se ressembler. Trois placements connus permettent de comparer chaque objet à chaque étape.
Méthodes de conversion Menyoo et Map Editor
Inspectez d’abord les options d’import de la version précise de CodeWalker installée. Utilisez un importateur spécifique seulement s’il identifie votre format. Une action XML générique ne prouve pas l’acceptation de tous les schémas. Notez version et option d’import avec la source.
Le logiciel original Map Editor & Menyoo to YMap Converter propose une solution historique documentée : ouvrir le XML pris en charge, exporter son fichier openFormats .ymap.xml, puis l’importer dans OpenIV pour produire un fichier natif. L’auteur documente aussi les entités exclues et les anciens prérequis. Ces instructions attestent ce flux, sans garantir sa compatibilité avec toute version moderne de Menyoo.
Utilisez uniquement la distribution de l’auteur et les dépendances indiquées. N’installez pas de DLL aléatoires et ne désactivez pas la sécurité pour forcer un ancien outil à démarrer. S’il refuse le format, conservez l’erreur et testez une petite sauvegarde plutôt que de renommer sans cesse.
Le page Menyoo maintenue par son auteur distingue les comportements selon les versions. Une scène actuelle peut contenir des fonctions absentes d’un ancien convertisseur. Notez ces limites de version dans vos tests.
Inspectez et enregistrez le YMAP obtenu
Ouvrez la carte native dans un projet CodeWalker de la même édition cible. Confirmez les trois références d’archétypes et comparez les coordonnées aux sources. Vérifiez la rotation sous plusieurs angles : une vue de dessus correcte peut cacher un placement incliné ou inversé.
Recalculez étendues et indicateurs avec les assets réellement chargés. Enregistrez, fermez puis rouvrez la carte native. Cela teste le fichier à livrer, pas un état non enregistré. La leçon du premier YMAP fournit le flux de placement.
Pour un exercice source dans le navigateur, téléchargez notre XML et JSON CodeWalker à trois objets. Ce sont des exemples de structure source de sortie, pas un cas certifié de conversion Menyoo ni une carte native testée en jeu.
Préparez le paquet et testez dans FiveM
Utilisez un nouveau dossier de ressource et le générateur de fxmanifest. Placez la carte compilée dans stream/ ; gardez le XML de travail ailleurs. Enregistrez des YTYP personnalisés uniquement si la carte dépend réellement des définitions fournies. Suivez le guide de streaming avant d’ajouter la ressource à un serveur en production.
Vérifiez nombre, positions, comportement à distance et collisions en développement. Répétez après reconnexion. Notez l’étape de l’échec : analyse source, conversion, rechargement CodeWalker, démarrage de ressource ou jeu.
Problèmes de conversion à isoler
Une erreur d’analyse exige d’abord de vérifier schéma XML et prise en charge du convertisseur. Des positions correctes sans modèles nécessitent un contrôle des dépendances et de l’édition. De grands décalages demandent de comparer les transformations locales et mondiales. Un comportement absent des peds, véhicules ou scripts peut relever du programme source plutôt que des données de carte.
Ne validez pas toute la scène parce qu’un objet est apparu. Utilisez le diagnostic des cartes manquantes pour une carte native qui charge mais échoue dans FiveM, et conservez l’original pour une autre conversion prise en charge.