Instala cada mapa o vehículo como un recurso independiente, mantén su estructura original, declara solo los archivos de datos que necesita y pruébalo en el entorno de prueba antes de la producción. Los mapas y los vehículos comparten el mismo ciclo de vida de los recursos, pero sus activos y pasos de validación difieren.
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.
Elige la ruta correcta
| Recurso | Contenidos típicos | Guía más profunda |
|---|---|---|
| Mapa/MLO | .ymap, .ytyp, modelos, texturas y colisiones |
Añade un FiveM MLO a un servidor |
| Vehículo | .yft, .ytd y archivos meta de vehículos documentados |
Sigue las notas de instalación actuales del paquete. |
Comprobaciones previas comunes
- Verifica el creador, la fuente, la licencia, la versión y la compilación/framework del juego compatible.
- Escanea el archivo y guarda el paquete original como evidencia de reversión.
- Haz una copia de seguridad de la configuración y de cualquier recurso que el paquete reemplace.
- Extrae en una carpeta de recursos dedicada con
fxmanifest.luaen su raíz. - Lee las dependencias y las notas de instalación antes de cambiar el manifiesto.
Instala un recurso de mapa
Mantén juntos los archivos .ymap, .ytyp, de modelos, texturas y colisiones suministrados. Conserva el manifiesto del creador. Utiliza this_is_a_map o una declaración DLC_ITYP_REQUEST únicamente cuando lo requieran el paquete y la documentación actual de Cfx.re; añadir directivas a ciegas puede ocultar el verdadero fallo del paquete.
Inicia el recurso en staging, recorre todo el límite, inspecciona interiores y colisiones, y comprueba si hay colocaciones de mapa duplicadas o si otro recurso está editando la misma área. Prueba a distancia y después de reconectar, no solo en el punto de aparición.
Instala un recurso de vehículo
Conserva los modelos y las texturas junto con los archivos de metadatos exactos documentados. Los paquetes habituales utilizan entradas como vehículos, comportamiento, variaciones y colores de coches, pero los tipos correctos de data_file proceden del paquete y de la referencia oficial de archivos de datos. No pegues todas las declaraciones conocidas en cada manifiesto de vehículo.
Un nombre de modelo no garantiza un comando de aparición. La aparición pertenece al framework instalado, al menú de administrador o al recurso del vehículo. Verifica el nombre del modelo configurado y usa el comando documentado o el flujo del garaje.
Habilita en orden de dependencia
Añade una línea ensure resource-name después de las bibliotecas necesarias y antes de los recursos que dependan de ese recurso. Reinicia el entorno de pruebas y revisa la consola del servidor y la consola F8 del cliente. Resuelve los archivos ausentes, los manifiestos incorrectos y los nombres duplicados en lugar de reiniciar repetidamente.
Prueba el recurso completo
- Mapa: colocación, portales, colisión, oclusión, iluminación, puertas y ediciones de IPL/mapa en conflicto.
- Vehículo: spawn, texturas, asientos, puertas, luces, audio, manejo, daño y persistencia en el garaje.
- Ambos: descarga de recursos desde un cliente limpio, reconexión, reinicio del servidor, reinicio del recurso y salida de los registros.
Aislar conflictos
Deshabilita otros recursos que modifiquen la misma área del mapa, nombre del modelo o entrada de metadatos, luego vuelve a habilitarlos uno por uno. Cambia solo una variable por prueba. Cambiar el nombre de una carpeta de recursos no resuelve los identificadores de activos en conflicto dentro de ella.
Restauración
Elimina la nueva entrada ensure, restaura los archivos y la configuración anteriores y revierte los cambios documentados de la base de datos. Reinicia y repite la ruta de referencia o el proceso con el vehículo. Mantén el recurso desactivado hasta que el defecto se haya reproducido y corregido en el entorno de pruebas.