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.
Navegar 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	Correr `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

Lista de verificación práctica

Utilice esta guía como lista de verificación antes de modificar un servidor FiveM en producción. Confirme la versión actual del artefacto del servidor, la versión del framework, las dependencias de recursos, los cambios en la base de datos y cualquier archivo del lado del cliente antes de aplicar el cambio.

Realice una copia de seguridad de los archivos de configuración y las tablas de la base de datos afectados.
Primero, aplique el cambio en un servidor de prueba.
Supervise la consola del servidor y la consola F8 del cliente para detectar errores.
Comprueba si el cambio afecta a los trabajos, el inventario, los vehículos, los mapas, la voz, los permisos o los datos del jugador.
Documente el archivo, comando o configuración exactos que modificó para que se puedan revertir rápidamente.

Pruebas previas a la producción

Tras la primera prueba, inicia sesión con una cuenta de jugador normal y repite el proceso desde la perspectiva del jugador. Si el tema está relacionado con el rendimiento, realiza mediciones antes y después con el mismo número de jugadores, ruta y conjunto de recursos. Si se trata de herramientas o permisos de administrador, verifica tanto a los usuarios autorizados como a los denegados.

Errores comunes

La mayoría de los problemas de FiveM se deben a dependencias faltantes, caché obsoleta, nombres de carpeta incorrectos, incompatibilidad de framework o configuración copiada de otro servidor. Evite modificar varios sistemas a la vez; realice un cambio, pruébelo y luego continúe.

Recursos relacionados

Para obtener recursos listos para la producción, compare los recursos de pago en el Tienda FiveMX. Para obtener recursos gratuitos, navegue Recursos de FiveM y pruebe cada recurso antes de usarlo públicamente.

Notas sobre el lanzamiento de la producción

Antes de usar esta guía en un servidor FiveM en vivo, define el resultado exacto que esperas del cambio. Para Cómo Agregar un FiveM MLO a Tu Servidor, eso significa verificar qué recurso, configuración, comando o flujo de trabajo se ve afectado y confirmar que el cambio se ajusta a tu framework actual, versión del artifact y reglas del servidor. Mantén la implementación lo suficientemente pequeña como para poder revertirla rápidamente si los jugadores reportan errores.

Utilice un servidor de pruebas con la misma estructura, esquema de base de datos, orden de recursos y dependencias clave que el servidor de producción. Si el problema afecta la jugabilidad, los permisos, los gráficos, el audio, los vehículos, los mapas, el inventario o el comportamiento económico, realice pruebas con al menos una cuenta de administrador y una cuenta de jugador normal. Observe la salida de la consola del servidor, los registros F8 del cliente y la temporización de los recursos mientras reproduce el flujo de jugadores exacto que se producirá en el servidor en producción.

Lista de verificación de reversión

Guarde el archivo de configuración anterior, la carpeta de recursos y el estado de la base de datos antes de realizar cualquier cambio.
Anota la versión del recurso, la confirmación, la página de descarga o el valor de configuración que hayas probado.
Reinicia primero solo el recurso afectado, si es posible, y luego reinicia el servidor completo si las dependencias lo requieren.
Si aparecen errores, revierta el único recurso o configuración que haya cambiado antes de probar otra solución.

Guía de mantenimiento

Revise esta configuración nuevamente después de las actualizaciones de artefactos FiveM, actualizaciones del marco de trabajo o cambios importantes en los recursos. Una configuración que funciona hoy puede dejar de funcionar después de actualizaciones de dependencias, exportaciones renombradas, eventos modificados o migraciones de bases de datos. Conserve notas junto con la documentación de su servidor para que los futuros administradores comprendan qué se modificó, por qué se modificó y cómo verificarlo nuevamente.

Revisión en curso

Vuelve a verificar Cómo Agregar un FiveM MLO a Tu Servidor después de actualizaciones importantes del artifact de FiveM, cambios de framework o migraciones de recursos. Confirma que el consejo aún coincida con el comportamiento actual del servidor, que cualquier fuente vinculada siga disponible y que los pasos de instalación aún coincidan con los archivos que un propietario de servidor realmente descargará o configurará.

Para servidores públicos, mantén un breve registro de cambios junto a la documentación del servidor. Indica qué se probó, qué se modificó, qué cuentas se usaron para la verificación y cómo revertir los cambios. Esto agiliza el mantenimiento futuro y evita que las notas de configuración antiguas se vuelvan confusas o inseguras para los jugadores.