Compilaciones de Juego de FiveM Explicadas

Una compilación de juego FiveM selecciona la línea base de contenido GTA V que un servidor espera que los clientes usen. Los propietarios de servidores usan sv_enforceGameBuild cuando un recurso necesita activos o nativos de una compilación DLC particular. La compilación más reciente disponible no es automáticamente la opción más segura para un servidor establecido.

Los ejemplos de configuración y código aquí están dirigidos a FiveM para GTA V Legacy. Enhanced tiene diferentes reglas de tiempo de ejecución y compatibilidad; consulta los cambios de Legacy a Enhanced de Cfx.re antes de aplicarlos a un servidor Enhanced.

Qué cambia sv_enforceGameBuild

La variable del servidor pide a los clientes que se conectan que usen la compilación del juego configurada. Eso puede habilitar vehículos, mapas, ropa, armas y funciones nativas relacionadas de DLC que los recursos necesitan. No actualiza tus scripts, ni repara activos incompatibles ni demuestra que todos los recursos de cliente admitan la compilación seleccionada.

# server.cfg — example only; choose a tested supported build
set sv_enforceGameBuild 2189

El ejemplo selecciona la línea base de Cayo Perico, no una recomendación universal. Establece este valor al inicio y reinicia completamente FXServer. Usa los valores admitidos en la documentación actual de Cfx. No pegues un número de compilación de un artículo sin fecha en producción.

Cuándo cambiar la compilación

• Un recurso documentado requiere contenido o nativos introducidos en una versión más reciente.
• Tu versión actual ya no es compatible con la plataforma o con una dependencia crítica.
• Tienes una ventana de publicación definida, resultados de pruebas en un entorno de ensayo y un plan de reversión.

No lo cambies solo porque exista un número mayor. Cada cambio de compilación forzada puede afectar mapas, ropa, vehículos, scripts y descargas de clientes al mismo tiempo.

Lista de verificación para cambio de compilación

1. Haz una copia de seguridad de la base de datos, la configuración del servidor y el conjunto completo de recursos.
2. Registra las versiones actuales de la compilación y los artefactos.
3. Actualiza primero el entorno de prueba y borra solo las cachés que el procedimiento oficial requiera.
4. Prueba la conexión al servidor, la selección de personajes, la ropa, los interiores, los vehículos, las armas y la voz.
5. Ejecuta recursos que utilicen nativos o activos específicos de la compilación.
6. Prueba con una cuenta de jugador normal, un administrador y más de un cliente.
7. Revisa los errores del servidor y de la consola F8 y compara el rendimiento con la línea base.
8. Mantén la configuración y los artefactos anteriores listos para la reversión.

Versión del juego versus artefactos del servidor

Resuelven problemas diferentes. La versión del juego controla la línea base de contenido GTA; los artefactos de FXServer entregan el entorno de ejecución del servidor. Actualizar uno no implica que el otro deba cambiar en la misma versión. Separa los cambios cuando sea posible para que una regresión tenga una causa clara.

Fallos comunes

La falta de modelos o interiores suele indicar una incompatibilidad entre los activos y la compilación. Los errores de script pueden indicar una suposición sobre una función nativa o una dependencia. Un fallo que afecte a muchos clientes inmediatamente después del cambio es un incidente del lanzamiento: primero revierte el cambio y después reproduce el problema en el entorno de pruebas. Conserva el error exacto, el recurso afectado y las versiones anterior y nueva junto al registro del incidente.

Para el mantenimiento del tiempo de ejecución, continúe con actualizando los artefactos del servidor FiveM.

Documentación de referencia

Cfx.re — comandos del servidor