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
- Pare o servidor.
- Abra o arquivo de configuração que é executado na inicialização.
- Adicione uma destas linhas:
sv_enforceGameBuild 2189ou
sv_enforceGameBuild h4 - 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
- Faça backup de
server.cfge da configuração do recurso afetado. - Teste a build e o recurso da ilha escolhidos em uma cópia de staging.
- Verifique empregos, veículos, inventários e mapas — não apenas a ilha.
- Implemente durante uma janela de manutenção com um rollback documentado.
Referência oficial
A lista atual de builds e o comportamento das opções aplicadas apenas na inicialização estão documentados na referência oficial de comandos de servidor do Cfx. Para encontrar outros recursos de servidor, explore os recursos FiveM ou a loja RPCrate.