Cómo instalar y verificar un MLO de FiveM

Instala un MLO de FiveM manteniendo intacto su paquete de recurso, iniciándolo después de sus dependencias y comprobando la ubicación exacta en el juego. Que el recurso arranque correctamente es solo la primera comprobación: las texturas, las colisiones, la visibilidad y otros mapas también deben funcionar.

Confirma la edición de GTA de destino antes de instalar o exportar assets. Los paquetes de Legacy no son automáticamente compatibles con Enhanced; sigue la guía oficial de conversión de activos de Enhanced cuando ese sea tu objetivo.

Comprueba el paquete antes de subirlo

Lee la versión del juego compatible, las dependencias, las notas de instalación y la licencia del creador. Conserva el archivo original y el mapa/configuración que funciona actualmente. Prueba primero en un servidor aislado.

La carpeta del recurso debe contener su manifest directamente y sus assets en streaming con la estructura documentada. Conserva los nombres y los archivos ocultos. Separar las carpetas de recursos facilita la reversión, pero no evita las colisiones de hash de modelos o mapas.

Instala y registra

1. Sube el recurso completo dentro de resources, opcionalmente en una carpeta de agrupación como [maps]. Evita que quede por accidente una carpeta extra del archivo por encima de fxmanifest.lua.
2. Conserva el manifest suministrado. Si un paquete no incluye ninguno, determina los tipos de assets reales y las declaraciones necesarias antes de crearlo; no asumas que todos los mapas necesitan los mismos archivos.
3. Para arquetipos YTYP adicionales, comprueba que el paquete declara DLC_ITYP_REQUEST con la ruta real de su YTYP. Consulta la referencia oficial de archivos de datos.
4. Añade ensure seguido del nombre exacto de la carpeta del recurso en server.cfg, después de las dependencias necesarias. Inícialo en staging e inspecciona el primer error de consola.

Prueba la ubicación

1. Usa la función de teletransporte documentada de la herramienta de administración que tengas instalada o desplázate hasta las coordenadas suministradas. No existe un comando universal de teletransporte con barra inicial.
2. Recorre todas las puertas y todas las plantas. Comprueba si falta colisión, si hay barreras invisibles, referencias de texturas, parpadeos y la visibilidad de las habitaciones.
3. Prueba varias condiciones de iluminación usando el sistema de hora/clima que tu servidor ejecuta realmente. Compara la misma ruta de cámara antes y después de activar el mapa.
4. Únete con otro jugador, reconéctate y reinicia. Comprueba un cliente sin tus archivos de desarrollo locales.

Resuelve los conflictos y revierte los cambios

Si la zona falla solo cuando otro mapa está activado, compara las colocaciones que se solapan y los nombres de arquetipo/modelo en staging. No renombres un drawable por sí solo: puede que las referencias de otros archivos dependan de él.

Mantén el estado normal de la caché para la primera comparación. Borra únicamente la caché concreta documentada para un problema de archivos obsoletos ya diagnosticado, con el cliente/servidor detenido según corresponda. Un borrado recursivo generalizado no es un paso de instalación.

Si el mapa no pasa la aceptación, detenlo, elimina su línea ensure y restaura la configuración de mapas anterior. Corrige el origen u obtén un paquete compatible antes de volver a intentarlo.

Documentación de referencia

Cfx.re — manifiesto de recursos