Cómo agregar un MLO de FiveM a su servidor

Audiencia: Propietarios de servidores y desarrolladores que ya operan una instancia de FiveM funcional y desean ampliarla con recursos de mapas interiores/exteriores (MLO) personalizados.

1 · Requisitos previos

Requisito	Versión mínima	Por qué es importante
Artefacto del servidor FiveM	6016 (compilación 7116) o posterior	Los artefactos más antiguos no pueden cargar los modernos `cerulean` manifiestos fx.
Cargador de mapas (ya integrado)	Nativo por defecto	No se necesita ningún complemento adicionalFiveM transmite archivos de mapa automáticamente.
Acceso al servidor	SFTP/SSH + permisos de escritura	Debes subir archivos y editarlos servidor.cfg.
Licencia legal	Comprobante de compra / Condiciones de uso gratuito	El RGPD de la UE y la política de Rockstar prohíben la distribución de activos sin licencia.

2 · Descargue e inspeccione el paquete MLO

Integridad de la fuente – Prefiera proveedores con archivos zip firmados con SHA-256 o etiquetas Git públicas.
Verificar la estructura – Un recurso conforme se parece a:

my-mlo/
 ├─ stream/
 │ ├─ *.ydr ↰ (models)
 │ ├─ *.ytyp ↰ (item definitions)
 │ ├─ *.ybn ↰ (collisions‑―if supplied)
 │ └─ *.ytd ↰ (textures)
 ├─ fxmanifest.lua
 └─ README.md (optional)

Crear fxmanifest.lua Si falta – Plantilla mínima:

fx_version 'cerulean'
games { 'gta5' }

author 'YourName'
description 'My Custom MLO'
version '1.0.0'

this_is_a_map 'yes'

files {
 'stream/**/*.ydr',
 'stream/**/*.ytyp',
 'stream/**/*.ytd',
 'stream/**/*.ybn'
}

data_file 'DLC_ITYP_REQUEST' 'stream/**/*.ytyp'

ℹ️ Los manifiestos de recursos estándar siguen el esquema en Documentación de FiveM → “Manifiesto de recurso” (commit 20b7b15, 2025-03-11)

3 · Subir el recurso

Conéctese a través de SFTP a la raíz de su servidor.
Navega a /resources/[maps]/—crea la carpeta bracket si no existe.
Subir el archivo completo my-mlo directorio sin alterar. Evite espacios y mayúsculas en los nombres de carpetas para evitar problemas con las rutas de Linux.

4 · Registrarse en `server.cfg`

Añadir (o reemplazar) start) después Recursos básicos esenciales:

ensure my-mlo # loads on boot; restarts automatically on txAdmin soft‑restarts

Guarde el archivo y Reanudar el servidor o ejecutar refresh ➜ ensure my-mlo en la consola en vivo.

5 · Borrar caché y reiniciar (si es necesario)

FiveM almacena en caché los datos de mapas. Para evitar las imágenes fantasma de versiones anteriores:

# Linux
rm -rf cache/*
./run.sh +exec server.cfg

# Windows (PowerShell)
Remove-Item -Recurse -Force .cache*
run.cmd +exec server.cfg

Cómo borrar la caché de los servidores de FiveM

6 · Lista de verificación de verificación en el juego

Controlar	Comando/herramienta	Criterios de aprobación
Teletransportarse	vMenu → Misc → Teletransporte → Ingresar coordenadas	El jugador aparece en el nuevo interior/exterior.
Integridad de la textura	`profile_frame` luego camina alrededor	Sin marcadores de posición de color rosa/blanco; pérdida de FPS < 10%.
Colisión	Muros de paso y rampas	Sin barreras invisibles ni caídas a través del suelo.
Iluminación	Cambio de ciclo temporal con `/time 23 0`	El interior se oscurece/ilumina correctamente sin artefactos.

Si ocurre algún fallo, vuelva a revisar la lista de archivos faltantes. .ytd o .ybn es el culpable habitual.

7 · Transmisión segura de múltiples MLO

Un recurso por MLOEsto evita las colisiones hash.
Prefije los nombres con la etiqueta del proveedor, por ejemplo bh-bank-lobby, para facilitar su desactivación.
Utilice la misma versión de manifiesto en todos los recursos del mapa para evitar advertencias de análisis.

8 · Solución de problemas de referencia rápida

Síntoma	Causa probable	Resolución
Consola: No se pudo analizar el manifiesto	Mala sintaxis de Lua	Ejecutar `lua -p fxmanifest.lua` localmente; arreglar comillas/comas.
MLO visible, texturas faltantes	`.ytd` archivos no referenciados	Añadelos a `files{}` o colocar en `stream/`.
Los jugadores se bloquean al unirse	Hash de propiedad duplicado en todos los mapas	Cambiar el nombre del duplicado `.ydr` o descargar recursos conflictivos.
Largo tiempo de descarga	Grande `.ytd` texturas	Comprimir texturas (DXT5/BC3) o reducir su escala.

9 · Notas sobre cumplimiento y protección de datos

Regulación / Política	Lo que debes hacer
Política de modificación de Rockstar (15/09/2015)	No venda activos que contengan propiedad intelectual de Rockstar.
RGPD UE, artículos 44-49	Almacenar facturas de proveedores; revelar el origen de los activos a solicitud del usuario.
FiveM Condiciones de servicio §3.2	Mantenga los créditos intactos; no redistribuya mods pagos públicamente.

Conclusión

Subir → ensure → reiniciar; si el manifiesto es válido, su nuevo interior estará activo en dos minutos.

¿Necesita nuevos MLO?

Fuentes

Documentación de FiveM – Manifiestos de recurso (accedido el 22 de mayo de 2025)
Rockstar Games – Política de modding, 15 de septiembre de 2015
Reglamento (UE) 2016/679 (RGPD), artículos 44‑49