Para hacer disponible el contenido de Cayo Perico en un servidor FiveM, establece el build de juego forzado al inicio en el build 2189 o cualquier build compatible posterior. La versión 2189 es la versión del atraco a Cayo Perico y también puede seleccionarse con el alias h4. Cada versión posterior del juego incluye contenido de versiones anteriores.
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.
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.
Habilita el build del juego de Cayo Perico
- Detén el servidor.
- Abre el archivo de configuración que se ejecuta al inicio.
- Añade una de estas líneas:
sv_enforceGameBuild 2189o
sv_enforceGameBuild h4 - Inicia de nuevo el servidor y confirma la compilación seleccionada en la consola del servidor.
sv_enforceGameBuild solo puede establecerse al inicio del servidor. Ingresarlo después de que el servidor haya comenzado no cambiará la versión del juego activa.
¿Debes usar la compilación 2189 o una más reciente?
Usa 2189 cuando necesites la compilación más antigua que contiene Cayo Perico. Usa una compilación admitida posterior cuando otros recursos requieran contenido más nuevo de GTA Online. Prueba tu pila completa de recursos después de cambiar de compilaciones, ya que los vehículos, mapas y scripts pueden depender de una compilación particular.
Versión del juego versus carga de la isla
La compilación del juego hace disponibles los activos de Cayo Perico. No garantiza que cada recurso del servidor cargue la isla, envíe a los jugadores allí o configure las colisiones correctamente. Algunas pilas de servidores usan un recurso de isla/IPL dedicado o un script de viaje personalizado. Sigue la documentación del recurso mantenido que instales; no descargues un ZIP antiguo simplemente porque un tutorial lo nombre.
Verificar Cayo Perico
- Reinicia completamente el servidor en lugar de reiniciar solo un recurso.
- Únete con una sesión de cliente limpia y viaja a la isla usando la ruta compatible de tu servidor.
- Comprueba el terreno, las colisiones, la vegetación, las puertas y los interiores.
- Revisa la consola del servidor y la consola F8 para detectar recursos ausentes o errores del mapa.
- Prueba con el mismo comportamiento de OneSync y routing-bucket utilizado en producción.
Solución de problemas
La isla es invisible o incompleta
Confirma la compilación de inicio primero. Luego verifica que el recurso de la isla/IPL se inicie correctamente y no entre en conflicto con otro recurso del mapa.
Los jugadores caen a través del mapa
Comprueba las colisiones y el orden de inicio de los recursos. Desactiva temporalmente los recursos de mapas de Cayo Perico que entren en conflicto y vuelve a probar una implementación cada vez.
El servidor no se iniciará después del cambio
Restaura la línea de compilación anterior, revisa el error de la consola y confirma que el número de compilación o alias esté listado en la documentación actual de Cfx.
Lista de verificación de producción
- Haz una copia de seguridad de
server.cfgy la configuración del recurso afectado. - Prueba la compilación elegida y el recurso de la isla en una copia de prueba.
- Verifica trabajos, vehículos, inventarios y mapas, no solo la isla.
- Despliega durante una ventana de mantenimiento con una reversión documentada.
Referencia oficial
La lista de compilaciones actuales y el comportamiento solo de inicio están documentados en la referencia oficial de comandos del servidor Cfx. Para recursos adicionales del servidor, navega por recursos de FiveM o la Tienda RPCrate.