Instale cada mapa o vehículo como un recurso independiente, mantenga su estructura original, declare solo los archivos de datos que necesita y pruébelo en staging 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.
Revisado el 9 de agosto de 2026 según el Cfx.re oficial manifiesto de recursos, archivo de datos y desarrollo de activos referencias. La inspección de mapas puede usar el proyecto mantenido CodeWalker.
Elija 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. |
Pre-vuelo compartido
- 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 el suministrado .ymap, .ytyp, modelo, textura y archivos de colisión juntos. Conserva el manifiesto del creador. Usa this_is_a_map o una DLC_ITYP_REQUEST declaración solo cuando el paquete y la documentación actual de Cfx.re los requieran; añadir directivas ciegamente puede ocultar el fallo real del empaquetado.
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
Mantén los activos de modelo y textura con los archivos de metadatos documentados exactos. Los paquetes comunes usan entradas como vehículos, manejo, variaciones de coche y colores de coche, pero el correcto data_file los tipos provienen del paquete y de la referencia oficial del archivo de datos. No pegues cada declaración conocida 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 ensure resource-name línea después de las librerías requeridas y antes de los recursos que dependen de ella. Reinicie el entorno de prueba e inspeccione la consola del servidor y la consola F8 del cliente. Resuelva los archivos faltantes, los manifiestos incorrectos y los nombres duplicados en lugar de reiniciar repetidamente.
Pruebe 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 limpia del cliente, reconexión, reinicio del servidor, reinicio del recurso y salida de registro.
Aislar conflictos
Deshabilite otros recursos que modifiquen la misma área del mapa, nombre del modelo o entrada de metadatos, luego vuelva a habilitarlos uno por uno. Cambie solo una variable por prueba. Cambiar el nombre de una carpeta de recursos no resuelve los identificadores de activos en conflicto dentro de ella.
Reversión
Eliminar la nueva ensure entrada, restaure los archivos/configuración anteriores y revierta los cambios documentados en la base de datos. Reinicie y repita la ruta base o el flujo del vehículo. Mantenga el recurso deshabilitado hasta que el defecto se reproduzca y se corrija en el entorno de prueba.
