¿Cómo instalo MLO y mapas personalizados en mi servidor FiveM?

¿Quieres darle a tu servidor FiveM una identidad propia con interiores personalizados y modificaciones del mapa? Tarde o temprano acabarás con MLO y archivos ymap. En esta guía instalas paso a paso un MLO o mapa personalizado en tu servidor de MC-Node: montas la estructura de carpetas correcta con una carpeta stream, creas un fxmanifest.lua correcto, subes el recurso por SFTP y lo activas todo con ensure en tu server.cfg. También aprenderás a resolver los problemas más habituales, como interiores que no cargan o jugadores que atraviesan el suelo.

¿Cuál es la diferencia entre un MLO y un ymap?

Ambos modifican el mundo del juego, pero de forma distinta:

• Ymap — un archivo de colocación que añade o mueve objetos existentes (props) en el mundo: vallas, decoración, cortes de carretera o un edificio extra visto desde fuera. Ligero y sencillo; a menudo basta con un único archivo .ymap.
• MLO (Multi-Level Object) — un interior completo en el que se puede entrar, con sus propias habitaciones, portales, colisiones e iluminación. Un MLO suele constar de varios archivos: .ydr (modelos), .ybn (colisión), .ytd (texturas), un .ytyp (definición del interior) y un .ymap (colocación).

En resumen: un ymap coloca algo, un MLO construye algo en lo que puedes entrar. La instalación es casi idéntica, pero un MLO es más propenso a errores porque el .ytyp debe cargarse correctamente.

Paso 1: Monta la estructura de carpetas correcta

1. Descomprime el MLO o mapa personalizado descargado en tu ordenador y revisa qué archivos contiene.
2. Crea una única carpeta de recurso con un nombre corto, sin espacios ni mayúsculas, por ejemplo vanilla_hotel.
3. Coloca todos los archivos de streaming (.ydr, .ybn, .ytd, .ytyp y .ymap) en una subcarpeta llamada stream.
4. Coloca un archivo fxmanifest.lua en la raíz del recurso.

La estructura queda así:

vanilla_hotel/
├── fxmanifest.lua
└── stream/
    ├── hotel_interior.ydr
    ├── hotel_interior.ybn
    ├── hotel_textures.ytd
    ├── hotel.ytyp
    └── hotel.ymap

Un fxmanifest.lua mínimo y correcto para un recurso de mapa:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

La línea this_is_a_map 'yes' le indica a FiveM que este recurso contiene datos del mundo, de modo que el mapa se recargue correctamente al reiniciar el recurso. Si el creador incluye líneas adicionales, como data_file 'DLC_ITYP_REQUEST' 'stream/hotel.ytyp', déjalas tal cual.

Paso 2: Sube el recurso por SFTP

1. Conéctate a tu servidor por SFTP. Cómo configurarlo se explica en SFTP con WinSCP o FileZilla.
2. Navega a la carpeta resources de tu servidor FiveM.
3. Sube la carpeta del recurso completa, incluida la subcarpeta stream. También puedes colocar el recurso en una carpeta de categoría como [maps].
4. ¿Usas FileZilla? Antes de subir, configura Transferencia → Tipo de transferencia → Binario. En modo ASCII o Auto, FileZilla puede corromper archivos binarios como .ydr y .ybn, y tu interior nunca cargará.

Los recursos pequeños también se pueden subir desde la pestaña Files del panel, pero para MLO con archivos de streaming grandes el SFTP es más fiable. El procedimiento general está en ¿Cómo subo un script?

Paso 3: Añade ensure en server.cfg

1. Abre server.cfg desde la pestaña Files del panel (o por SFTP).
2. Añade la línea ensure vanilla_hotel, con exactamente el mismo nombre que tu carpeta de recurso.
3. Cuida el orden: coloca los recursos de mapa por encima de los scripts que necesitan el interior, como scripts de housing, garajes o teletransporte. Con un orden de ensure incorrecto, un script así arranca cuando el interior todavía no existe.
4. Guarda el archivo y reinicia tu servidor desde la pestaña Console.
5. Comprueba en la consola que aparece Started resource vanilla_hotel y acércate a la ubicación dentro del juego.

Problemas habituales

• El interior es invisible o no carga — Comprueba primero en la consola que el recurso realmente ha arrancado. Si arranca, a menudo los archivos se subieron corruptos o el .ytyp no se está cargando: vuelve a subir toda la carpeta stream en modo binario y verifica que this_is_a_map 'yes' está en el fxmanifest.lua.
• Atraviesas el suelo — Falta el archivo de colisión (.ybn) o está dañado. Compara los tamaños de archivo del servidor con los de tu PC; si difieren, la subida falló.
• Dos MLO en la misma ubicación — Paredes que parpadean, puertas duplicadas o un interior en negro suelen indicar dos recursos que modifican el mismo edificio. Elimina la línea ensure de uno de los dos y reinicia el servidor.
• Error por assets demasiado grandes — Un mensaje en la consola de que un asset supera el límite de tamaño casi siempre se debe a archivos de texturas .ytd demasiado pesados. Usa una versión optimizada o reduce las texturas (por ejemplo de 4K a 2K); los mapas demasiado pesados también provocan tiempos de carga largos y crashes del cliente.
• Errores de script tras añadir el mapa — Revisa el orden en server.cfg: el recurso del mapa debe cargarse antes que los scripts que hacen referencia a él.

¡Listo!

Tu servidor ya streamea tus propios MLO y mapas personalizados. ¿Sigues atascado? Abre un ticket en nuestra página de soporte e indica el nombre del recurso y el mensaje de error exacto de la consola.