Game Builds do FiveM Explicados

Um game build do FiveM seleciona a linha de base de conteúdo do GTA V que um servidor espera que os clientes usem. Os proprietários de servidores usam sv_enforceGameBuild quando um recurso precisa de assets ou nativos de um build de DLC específico. O build mais recente disponível não é automaticamente a escolha mais segura para um servidor estabelecido.

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.

O que sv_enforceGameBuild altera

A variável do servidor solicita que os clientes que se conectam usem o game build configurado. Isso pode expor veículos, mapas, roupas e armas de DLC, além de nativos relacionados exigidos por recursos. Ela não atualiza seus scripts, não corrige assets incompatíveis nem prova que todo recurso do cliente suporta o build selecionado.

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

O exemplo seleciona a linha de base de Cayo Perico, não uma recomendação universal. Defina esse valor na inicialização e reinicie completamente o FXServer. Use os valores suportados na documentação atual do Cfx. Não coloque em produção um número de build copiado de um artigo sem data.

Quando alterar o build

• Um recurso documentado requer conteúdo ou nativos introduzidos em um build mais recente.
• Seu build atual não é mais suportado pela plataforma ou por uma dependência crítica.
• Você tem uma janela de lançamento definida, evidências em staging e um plano de rollback.

Não o altere apenas porque existe um número maior. Toda alteração de build forçado pode afetar mapas, roupas, veículos, scripts e downloads dos clientes ao mesmo tempo.

Lista de verificação para alteração de build

1. Faça backup do banco de dados, da configuração do servidor e do conjunto completo de recursos.
2. Registre as versões atuais do build e dos artefatos.
3. Atualize o staging primeiro e limpe apenas os caches que o procedimento oficial exigir.
4. Teste a entrada no servidor, a seleção de personagem, as roupas, os interiores, os veículos, as armas e a voz.
5. Exercite os recursos que usam nativos ou assets específicos do build.
6. Teste com uma conta de jogador normal, uma de administrador e mais de um cliente.
7. Revise os erros do servidor e do console F8 e compare o desempenho com a linha de base.
8. Mantenha a configuração anterior e os artefatos prontos para rollback.

Game build versus artefatos do servidor

Eles resolvem problemas diferentes. O game build controla a linha de base de conteúdo do GTA; os artefatos do FXServer entregam o runtime do servidor. Atualizar um não implica que o outro deva mudar no mesmo lançamento. Separe as mudanças quando possível, para que uma regressão tenha uma causa clara.

Falhas comuns

Modelos ou interiores ausentes normalmente indicam uma incompatibilidade entre asset e build. Erros de script podem indicar uma suposição sobre um nativo ou uma dependência. Uma falha em massa dos clientes imediatamente após a mudança é um incidente de lançamento: reverta primeiro e depois reproduza em staging. Guarde o erro exato, o recurso afetado e as versões antiga e nova junto com o registro do incidente.

Para a manutenção do ambiente de execução, continue com atualizando artefatos do servidor FiveM.

Documentação de referência

Cfx.re — comandos do servidor