Pasar de XML a YMAP requiere una conversión específica del formato, no cambiar el nombre. Un archivo de colocaciones de Menyoo, uno de Map Editor de Guadmaz y un YMAP XML de CodeWalker pueden terminar en .xml, pero describen estructuras distintas. Identifica la herramienta de origen antes de elegir un importador.
Esta guía trata colocaciones estáticas de objetos. No promete conservar scripts, entidades móviles, peds, pickups, objetos adjuntos ni un interior MLO completo. Conserva el original y trabaja en una copia. Una colocación convertida no aporta modelos, texturas o colisión personalizados que nunca se incluyeron.
Identifica tu formato XML
Abre una copia en un editor de texto plano sin ejecutar nada. Comprueba el elemento raíz y la aplicación que lo guardó; no deduzcas el formato solo por la extensión.
| Entrada | Qué representa | Siguiente paso adecuado |
|---|---|---|
XML de CodeWalker con elemento raíz CMapData en la raíz |
Una representación textual de datos YMAP | Usa el flujo compatible de importación y compilación XML de CodeWalker |
| XML de colocaciones Menyoo | Una escena guardada de Object Spooner | Usa un importador compatible expresamente con ese formato Menyoo |
| XML de Map Editor de Guadmaz | El esquema de mapas guardados de ese editor | Usa un conversor compatible expresamente con XML de Map Editor |
Nativo .ymap |
Datos compilados del mapa, no XML textual | Ábrelo como archivo del juego en vez de renombrarlo a XML |
| Un JSON de proyecto Map Studio | El proyecto editable de planificación de este sitio | Abre en Map Studio, después exporta las fuentes compatibles |
El importador del navegador acepta XML compatible de CodeWalker CMapData XML, no cualquier XML de Menyoo o Map Editor. También rechaza mapas con vínculos padre en vez de presentar una edición parcial como un ciclo completo seguro. La guía de formatos de archivos explica la diferencia entre formato nativo y fuente.
Prepara un candidato pequeño para convertir
Guarda una escena con tres objetos estáticos cuyos nombres existan en tu instalación. Registra nombre, posición, rotación y escala. Evita depender de otros mods en la primera prueba. Lista aparte las funciones excluidas deliberadamente; la pérdida silenciosa no es una conversión correcta.
Guarda la fuente con otro nombre. Una escena con cientos de colocaciones es mala para el primer diagnóstico: una dependencia ausente, una transformación errónea y una entidad no compatible pueden parecer lo mismo. Tres colocaciones conocidas permiten comparar cada objeto tras cada etapa.
Rutas de conversión de Menyoo y Map Editor
Primero revisa las opciones de importación de la versión concreta de CodeWalker instalada. Usa un importador específico solo cuando identifique tu formato. Una acción XML genérica no demuestra compatibilidad con todos los esquemas. Registra versión y opción de importación junto a la fuente.
El original Map Editor & Menyoo to YMap Converter ofrece una alternativa histórica documentada: abrir el XML compatible, exportar su archivo openFormats .ymap.xml, después importarlo en OpenIV para producir un archivo nativo. El autor también documenta entidades excluidas y requisitos antiguos. Esas instrucciones describen ese flujo, no garantizan compatibilidad con toda versión moderna de Menyoo.
Usa solo la distribución del autor y las dependencias indicadas. No instales DLL aleatorias ni desactives la seguridad para forzar una utilidad antigua. Si rechaza el formato, conserva el error y prueba un archivo menor en vez de renombrarlo repetidamente.
El página mantenida por el autor de Menyoo distingue comportamientos según la versión. Una escena actual puede incluir funciones ausentes de un conversor antiguo. Registra esos límites de versión en las pruebas.
Inspecciona y guarda el YMAP resultante
Abre el mapa nativo en un proyecto CodeWalker de la misma edición. Confirma las tres referencias de arquetipos y compara coordenadas con la fuente. Revisa la rotación desde varios ángulos; una vista superior correcta puede ocultar una colocación inclinada o reflejada.
Recalcula extensiones e indicadores con los assets reales cargados. Guarda, cierra y vuelve a abrir el mapa nativo. Así pruebas el archivo que entregarás, no un estado sin guardar. La lección del primer YMAP ofrece el flujo de colocación.
Para practicar con fuentes del navegador, descarga nuestro XML y JSON CodeWalker de tres objetos. Son ejemplos de la estructura fuente de salida, no un caso certificado de conversión Menyoo ni un mapa nativo probado en el juego.
Empaqueta y prueba en FiveM
Usa una carpeta de recurso nueva y el generador de fxmanifest. Coloca el mapa compilado en stream/; conserva el XML de trabajo aparte. Registra YTYP personalizados solo si el mapa depende realmente de tus definiciones. Sigue la guía de streaming antes de añadir el recurso a un servidor en producción.
Comprueba cantidad, posición, comportamiento a distancia y colisión en desarrollo. Repite tras reconectarte. Registra la etapa del fallo: análisis fuente, conversión, recarga de CodeWalker, inicio del recurso o juego.
Problemas de conversión que aislar
Un error de análisis requiere revisar primero el esquema XML y el soporte del conversor. Posiciones correctas con modelos ausentes exigen comprobar dependencias y edición. Grandes desplazamientos requieren comparar transformaciones locales y mundiales. Un comportamiento ausente de peds, vehículos o scripts puede pertenecer al entorno de ejecución de origen y no a los datos del mapa.
No valides toda la escena porque apareció un objeto. Usa el diagnóstico de mapas ausentes para un mapa nativo que carga pero falla en FiveM, y conserva la fuente original para otra ruta de conversión compatible.