Como Habilitar Cayo Perico no FiveM

Para disponibilizar o conteúdo de Cayo Perico em um servidor FiveM, defina a build do jogo forçada na inicialização para a build 2189 ou qualquer build posterior suportada. A build 2189 é a build do Assalto a Cayo Perico e também pode ser selecionada com o alias h4. Toda build posterior do jogo inclui conteúdo das builds anteriores.

Confirme a edição de GTA de destino antes de instalar ou exportar assets. Pacotes Legacy não estão automaticamente prontos para o Enhanced; siga a orientação oficial de conversão de assets para o Enhanced quando esse for o seu objetivo.

A configuração e os exemplos de código aqui são voltados ao FiveM para GTA V Legacy. O Enhanced tem regras diferentes de runtime e de compatibilidade; verifique as alterações de Legacy para Enhanced do Cfx.re antes de aplicá-las a um servidor Enhanced.

Ative a build do jogo Cayo Perico

1. Pare o servidor.
2. Abra o arquivo de configuração que é executado na inicialização.
3. Adicione uma destas linhas:

   sv_enforceGameBuild 2189

   ou

   sv_enforceGameBuild h4

4. Inicie o servidor novamente e confirme a build selecionada no console do servidor.

sv_enforceGameBuild só pode ser definido na inicialização do servidor. Inseri-lo depois de o servidor ter iniciado não alterará a build do jogo ativa.

Você deve usar a build 2189 ou uma build mais recente?

Use a 2189 quando precisar da build mais antiga que contém Cayo Perico. Use uma build posterior suportada quando outros recursos exigirem conteúdo mais recente do GTA Online. Teste toda a sua pilha de recursos após alterar a build, pois veículos, mapas e scripts podem depender de uma build específica.

Build do jogo versus carregamento da ilha

A build do jogo torna os ativos de Cayo Perico disponíveis. Ela não garante que todos os recursos do servidor vão carregar a ilha, levar jogadores até lá ou configurar as colisões corretamente. Algumas pilhas de servidor usam um recurso dedicado de ilha/IPL ou um script de viagem personalizado. Siga a documentação do recurso mantido exato que você instalar; não baixe um ZIP antigo simplesmente porque um tutorial o menciona.

Verifique Cayo Perico

• Reinicie o servidor completamente, em vez de reiniciar apenas um recurso.
• Entre com uma sessão de cliente limpa e viaje até a ilha usando a rota suportada pelo seu servidor.
• Verifique o terreno, colisões, vegetação, portas e interiores.
• Verifique os consoles do servidor e F8 em busca de recursos ausentes ou erros de mapa.
• Teste com o mesmo comportamento de OneSync e de routing bucket usado em produção.

Solução de problemas

A ilha está invisível ou incompleta

Confirme primeiro a build de inicialização. Depois, verifique se o recurso de ilha/IPL inicia com sucesso e não entra em conflito com outro recurso de mapa.

Os jogadores caem através do mapa

Verifique colisões e a ordem de inicialização dos recursos. Desative temporariamente os recursos de mapa do Cayo Perico em conflito e reteste uma implementação por vez.

O servidor não iniciará após a alteração

Restaure a linha de build anterior, verifique o erro no console e confirme que o número ou alias da build está listado na documentação atual do Cfx.

Checklist de produção

1. Faça backup server.cfg e a configuração do recurso afetado.
2. Teste a build e o recurso da ilha escolhidos em uma cópia de staging.
3. Verifique empregos, veículos, inventários e mapas — não apenas a ilha.
4. Implemente durante uma janela de manutenção com um rollback documentado.

Referência oficial

A lista atual de builds e o comportamento que permite a definição apenas na inicialização estão documentados na referência oficial dos comandos do servidor Cfx. Para recursos adicionais do servidor, navegue em recursos FiveM ou o RPScripts loja.