¿Qué son los archivos YMAP?
Los archivos YMAP son el formato de colocación de mapas que usan GTA V y FiveM para definir dónde existen objetos, edificios y props en el mundo del juego. Cuando creas un interior o modificación de mapa para FiveM, estás creando en esencia un archivo YMAP que dice al motor qué modelos 3D colocar, dónde posicionarlos y cómo orientarlos. A diferencia de scripts simples de colocación de props que spawnean objetos en runtime, los archivos YMAP se cargan como parte del mundo del juego durante el streaming, lo que significa que se benefician del sistema de niveles de detalle integrado, occlusion culling y gestión de memoria del motor. Eso convierte a YMAP en el método preferido para crear adiciones permanentes al mapa que deban rendir bien en servidores con muchos jugadores.
Herramientas para desarrollo de mapas
La herramienta principal para crear mapas en FiveM es CodeWalker, una aplicación gratuita desarrollada por la comunidad que permite navegar, editar y exportar datos de mapa de GTA V. Con CodeWalker puedes colocar props de la librería integrada del juego, posicionarlos con precisión usando coordenadas y rotaciones y exportar tu creación como YMAP listo para streaming. Para trabajo más avanzado, Blender con el addon Sollumz te permite crear modelos 3D totalmente personalizados y exportarlos en los formatos que FiveM requiere. Muchos desarrolladores también usan herramientas in-game como Spooner o scripts personalizados de colocación de props para el trabajo inicial antes de exportar a YMAP. El flujo suele ser: colocación bruta in-game, refinado en CodeWalker y export final para producción.
Crear interiores personalizados
Los interiores personalizados son espacios cerrados como apartamentos, oficinas, tiendas o instalaciones subterráneas en los que los jugadores pueden entrar e interactuar. Crear un interior convincente exige atención a la geometría de colisión, iluminación y densidad de props. Empieza definiendo el shell del interior con modelos adecuados de paredes, suelo y techo y luego añade mobiliario, decoración y elementos funcionales. Los archivos de colisión (YBNF) deben coincidir con tu geometría visual para que los jugadores no atraviesen paredes ni se caigan por el suelo. La iluminación interior se gestiona con una combinación de light probes horneadas y fuentes de luz dinámicas definidas en tu YMAP. Prueba el interior a fondo caminando por cada esquina, buscando costuras visuales, huecos de colisión y zonas donde la cámara atraviese geometría.
Streaming y rendimiento
Los mapas personalizados se envían a los jugadores a medida que se acercan a la ubicación, así que el tamaño y la complejidad de los archivos afectan directamente a los tiempos de carga y al rendimiento del cliente. Mantén tus YMAP enfocados en un área razonable en lugar de desplegar props por todo el mapa en un único recurso. Los interiores grandes deberían dividirse en varios YMAP que carguen de forma independiente y deberías usar distancias de LOD adecuadas para evitar que los props lejanos consuman recursos de renderizado. El fxmanifest.lua de un recurso de mapa tiene que incluir tus YMAP e YTYP como entradas data_file con las declaraciones de tipo correctas. Monitoriza el rendimiento del cliente con el profiler integrado de FiveM para asegurarte de que tus mapas no causan caídas de FPS, especialmente en zonas donde muchos jugadores se concentran a la vez.
Librerías de props y buenas prácticas
GTA V viene con miles de props integrados que puedes usar en tus mapas sin añadir contenido extra de streaming. Aprender las convenciones de nombrado te ayuda a encontrar rápido los objetos correctos. Los props con prefijo prop_ son de uso general, los de v_ son mobiliario de interior y los de hei_ vienen de contenido relacionado con atracos. Al colocar props, alinéalos a una cuadrícula consistente para evitar objetos flotando y geometría superpuesta. Agrupa props relacionados de forma lógica y usa nombres descriptivos en tus YMAP para que otros desarrolladores entiendan la estructura del mapa. Prueba siempre tus mapas con la iluminación y el clima por defecto del juego, porque los props pueden verse muy distintos según el escenario de luz.