«No aparece» puede describir varios fallos: el recurso no inicia, el mapa coloca el interior en otro lugar, falta un arquetipo o una habitación desaparece solo desde un punto de vista. Empieza separando esas observaciones.
Es un proceso de decisión para el diagnóstico. No afirma que cada síntoma tenga una única causa posible.
Registra el estado del fallo
Registra la versión del recurso, edición de destino, coordenadas, dirección de cámara y recursos vecinos activos. Conserva los errores exactos del cliente y servidor cuando existan. Guarda una captura con contexto suficiente para volver a la posición.
Conserva la exportación con fallo antes de cambiarla. Un fallo reproducible es un caso de prueba útil. Si desaparece después de seis cambios sin relación, aprendes muy poco.
¿Falta todo el recurso?
Comprueba la ruta del recurso, el nombre del archivo y la salida de inicio. Inspecciona fxmanifest.lua y verifica que existan los archivos previstos con las mayúsculas, minúsculas y extensiones correctas. Confirma que pruebas la carpeta adecuada y no un duplicado antiguo.
Para arquetipos personalizados, inspecciona el registro YTYP y sus referencias. Compara los archivos entregados con la guía de empaquetado de recursos.
Un comando aceptado en la consola no significa que estuvieran disponibles todas las dependencias. Lee la salida y comprueba por separado la colocación visible.
¿El asset se abre pero no aparece en el mundo?
Comprueba la cadena asset → arquetipo → colocación de entidad. Usa la referencia de formatos de archivos para distinguir esas responsabilidades. Confirma el nombre exacto del arquetipo MLO y la transformación mundial aplicada a la colocación.
Comprueba que el mapa exportado incluya los últimos cambios y las extensiones calculadas cuando corresponda. Un proyecto guardado en tu equipo no demuestra que el servidor recibiera un YMAP nuevo.
Si creaste en espacio local, busca traslaciones o rotaciones duplicadas en los datos exportados y la colocación. No muevas el asset repetidamente hasta que aparezca sin comprender primero qué transformación se aplica.
¿Desaparece una habitación en una puerta?
Vuelve al grafo de habitaciones. Registra la abertura, el lado del umbral y la dirección que desencadenan el problema. Inspecciona la conexión y la configuración con la matriz de pruebas de portales.
Una captura gran angular sin relación no demuestra que funcione la conexión. Un fallo en una transición concreta exige probar esa transición.
Compara la misma ruta con la exportación funcional anterior. Si el fallo comenzó al añadir una habitación, limita el experimento a ese cambio en lugar de rehacer todos los materiales.
¿La habitación es visible pero el movimiento es incorrecto?
Pasa al diagnóstico de colisión. Una entrada puede estar bloqueada por colisión que no coincide con la abertura visible. Registrar repetidamente el mismo YTYP no arregla las caídas a través del suelo.
Inspecciona la colisión exportada y repite la ruta a pie. Comprueba recursos superpuestos en el mismo lugar. Desactiva los sospechosos solo en un entorno de desarrollo controlado y documenta cada comparación.
¿El problema depende de la distancia o de otros recursos?
Usa aproximaciones fijas para distinguir efectos de distancia y transiciones de habitaciones. El README explica la jerarquía LOD; no justifica aumentar todas las distancias sin revisar la jerarquía y los límites.
Ante posibles conflictos, prueba el recurso solo y añade los vecinos en un orden conocido. Registra la primera combinación que reproduce el problema. El orden es una observación que investigar, no sustituye comprender assets duplicados o superpuestos.
Completa el ciclo
En cada intento, anota hipótesis, cambio exacto y resultado. Restaura la versión anterior si falla la hipótesis. Reproduce una corrección funcional desde la fuente y repite las pruebas con una conexión nueva.
Las operaciones de caché no son un diagnóstico. Considera una entrega desactualizada solo si hay evidencias y sigue las indicaciones actuales, sin borrar carpetas ajenas por rutina.
YMAP no aparece en FiveM: aísla la primera capa ausente
Empieza por la detección de recursos y la consola; después comprueba el archivo nativo exacto en stream/, la edición de destino y las coordenadas. Un recurso reconocido con XML de texto en lugar de salida nativa no es un mapa funcional. Compara una apertura nueva en CodeWalker con el archivo entregado, no con otra copia del editor.
Si aparecen objetos del juego pero no los personalizados, revisa el registro YTYP y las dependencias de modelos/texturas. Si no aparece nada, confirma primero que cargó el YMAP. El generador de manifiestos ayuda a comparar declaraciones, pero no inspecciona archivos ni demuestra que se resuelvan las referencias.
MLO que parpadea en una puerta
Mantén la cámara quieta a cada lado y cruza la misma abertura en ambos sentidos. Registra qué habitación desaparece y dónde ocurre la transición. Compara geometría del portal, conexiones, límites y asignaciones. No cambies todo a la vez: un cambio controlado debe explicar una observación repetible.
Compara el mismo recorrido sin recursos de desarrollo superpuestos. Si solo fallan vistas lejanas, inspecciona LOD y streaming en vez de aumentar todas las distancias. Usa la guía de habitaciones y portales para comprobar el grafo y la lección de optimización para comparaciones reproducibles.
Interior invisible o colisión invisible
Una habitación no dibujada y otra que bloquea movimiento son síntomas distintos. Comprueba la barrera física con la superficie invisible y revisa renderizado y colisión por separado. Quitar colisión no repara un registro de arquetipo; añadir un portal no abre un hueco en un colisionador sólido.
Guarda el menor recurso reproducible con edición, versiones del juego/servidor, revisión fuente y observación exacta. Si la aplicación falla antes de abrir un mapa, usa el diagnóstico de inicio de CodeWalker en su lugar.