Cómo instalar un MLO en un servidor de FiveM: stream, fxmanifest, ensure

Descargaste un paquete de mapa con archivos como .ymap, .ytyp, .ybn y .ydr, y quieres que esté en tu servidor. Esta guía muestra el diseño de carpetas, fxmanifest.lua, la línea server.cfg y una forma rápida de probarlo en el juego.

#Qué hay dentro de un paquete de mapa

Un MLO (un interior personalizado) o un mapa es un recurso normal. Los archivos habituales son:

• .ymap: donde se sientan los objetos y el interior en el mundo.
• .ytyp: la definición del interior y de sus props personalizados (sus "arquetipos").
• .ybn: las colisiones. Sin ellas te caes a través del piso o caminas a través de paredes.
• .ydr y .ydd: los modelos 3D de props y partes.
• .ytd: las texturas.

Todo eso va en una carpeta llamada stream. FiveM envía todo en stream a los jugadores por sí solo, así que no enumeras esos archivos en el manifiesto.

#La estructura de carpetas

resources/[maps]/my_mlo/
  fxmanifest.lua
  stream/
    my_mlo.ymap
    my_mlo.ytyp
    my_mlo.ybn
    my_mlo_props.ydr
    my_mlo.ytd

Muchos paquetes vienen con otro nivel, como my_mlo-master/my_mlo/. Mueve la carpeta que contiene fxmanifest.lua a resources, o el servidor no puede encontrar el recurso.

#El fxmanifest.lua

Si el paquete viene sin un manifiesto, crea uno:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

this_is_a_map 'yes' le dice a FiveM que el recurso contiene datos de mapa. Si el paquete tiene un archivo .ytyp, agrega la línea que lo registra:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

data_file 'DLC_ITYP_REQUEST' 'stream/my_mlo.ytyp'

Usa una línea data_file por cada archivo .ytyp. La ruta es la ruta real en la carpeta, así que verifica el nombre y la minúscula/mayúscula de las letras.

Consejo: si el paquete ya vino con un manifiesto, mantenlo. El autor lo escribió para estos archivos exactos, y a menudo enumera varios archivos .ytyp u opciones adicionales que no quieres adivinar.

#Agrégalo a server.cfg

ensure my_mlo

El nombre después de ensure debe ser el nombre de la carpeta. Para iniciar todo un grupo, coloca los mapas en una carpeta con paréntesis y usa ensure [maps]. Los mapas no dependen de tu framework, pero inícialos después de tus otros recursos básicos para que un error de mapa no pueda bloquear los importantes. Más sobre eso en orden de recursos de server.cfg.

Reinicia el servidor, o escribe ensure my_mlo en la consola en vivo de txAdmin. Un .ytyp nuevo es más confiable con un reinicio completo.

#Requisito de compilación del juego

Algunos mapas usan props o modelos de un DLC de GTA V más nuevo. En la compilación de juego predeterminada, esos props faltan: ves salas vacías, una caja blanca o ningún interior en absoluto. La página del paquete generalmente dice la compilación que necesita. Establécela en server.cfg y reinicia:

set sv_enforceGameBuild 3095

El número anterior es solo un ejemplo: usa el que pide el paquete. La lista completa y los efectos secundarios están en sv_enforceGameBuild y DLC.

#Pruébalo en el juego

1. Lee la consola de txAdmin al iniciar. Los errores como un archivo faltante en data_file aparecen allí. Si el recurso no se inicia, ver no se pudo iniciar el recurso.
2. Únete al servidor. Ve a las coordenadas en el readme del paquete, con el teleport del menú de txAdmin o un comando de coordenadas de tu script de administrador.
3. Camina por la puerta. Un interior personalizado a menudo se carga solo cuando estés cerca, así que llega a pie y no desde lejos a alta velocidad.
4. Verifica el piso y las paredes. Si te caes o pasas a través, los archivos .ybn faltan o no se cargaron. Ver caer a través del mapa.

#Problemas comunes

• El interior no aparece. El recurso no se inicia, las coordenadas son incorrectas, o se necesita una compilación de juego más nueva. También verifica que los archivos estén dentro de stream y no un nivel más profundo en una subcarpeta que el recurso no utiliza.
• Los props faltan, pero las paredes están allí. El .ytyp no está registrado. Agrega la línea DLC_ITYP_REQUEST, con el nombre de archivo correcto.
• Parte de la sala parpadea o las paredes desaparecen. Otro mapa cubre la misma área. Ver conflictos de mapas.
• Las texturas se ven mal o pesadas. Las texturas grandes cuestan memoria de streaming. Ver activos sobredimensionados.
• Funcionaba, luego se rompió después de una actualización. Limpia la caché del cliente e intenta de nuevo: limpiar caché de FiveM.

#Muchos mapas en un servidor

Cada mapa agrega archivos transmitidos que cada jugador descarga y mantiene en memoria. Instala solo los mapas que usas, coloca cada uno en su propio recurso y nómbralo claramente. Cuando algo se rompe, puedes detener un recurso a la vez y encontrar la causa.

#Lista de verificación