Carros, roupas ou mapas DLC do FiveM desaparecendo? Defina sv_enforceGameBuild

Os jogadores dizem que os novos carros DLC estão invisíveis, o pacote de roupas mostra os itens errados ou vazios, ou um addon de mapa carrega com buracos. Os ativos são streamed, o recurso inicia sem erro, e ainda assim o conteúdo está faltando ou quebrado.

A razão usual é o build do jogo. FiveM executa versões antigas do GTA V por padrão, e conteúdo DLC mais novo só existe em builds mais novas.

#Por que o conteúdo desaparece

O GTA V recebe atualizações de DLC, e cada uma adiciona arquivos ao jogo: veículos, componentes de ped, props, interiores. O build de jogo padrão do FiveM é antigo de propósito, para que os servidores permaneçam compatíveis com cada jogador. Se um addon foi feito para um build mais novo, um jogador no padrão carece dos arquivos base a que se refere, e você obtém veículos invisíveis, roupas faltando ou crashes.

A correção é dizer ao servidor qual build os jogadores devem usar.

#A correção: sv_enforceGameBuild

Adicione isto ao server.cfg:

set sv_enforceGameBuild 3258

Coloque perto do topo, antes das linhas ensure, depois reinicie o servidor completamente. Os jogadores que entrarem depois são solicitados a usar aquele build.

#Game builds e o que desbloqueiam

Escolha o build para o DLC mais novo que seu conteúdo precisa:

Um build mais alto inclui tudo dos mais baixos. Se seu pacote precisa de conteúdo Tuners, 2372 é suficiente, mas 3407 também funciona. Cada novo DLC adiciona um build mais novo; os documentos do FiveM listam os mais recentes que seus artefatos de servidor suportam.

Dica: não defina o build mais alto "só para ter certeza". Cada passo faz os jogadores baixarem mais e pode mudar o comportamento de ativos mais antigos. Use o build mais baixo que cubra seu conteúdo.

#O que acontece quando os jogadores entram

A primeira vez que alguém entra em um servidor que força um build que ele não possui, o FiveM baixa aquele build de jogo. Isso pode levar alguns minutos e pode precisar que o jogo reinicie. Depois disso, é armazenado em cache, e entrar é normal novamente.

Diga aos seus jogadores sobre isso no seu Discord, ou uma entrada de primeira vez parece que o servidor está congelado. Os jogadores que já usam outro build para outros servidores são solicitados novamente quando voltam.

#Builds mais altos precisam de ativos atualizados

Um build de jogo mais novo muda os arquivos do jogo base, e alguns ativos mais antigos não esperam por isso. Observe:

• Veículos addon com arquivos de handling ou meta antigos: geralmente ainda funcionam, mas verifique-os.
• Pacotes de roupas construídos para um build mais antigo: verifique se as roupas salvas ainda parecem corretas após a mudança.
• MLOs e mods de mapa: interiores que substituem a mesma área que uma mudança de DLC nova podem se sobrepor com ela.
• Scripts que hardcode hashes de modelo ou componentes de ped: verifique suas notas de atualização.

Teste em uma cópia do servidor, com um cliente limpo, antes de aumentar o build em um servidor ao vivo. Procure por novos erros em seus recursos no console após a mudança, e veja leia um erro de script FiveM se tiver dificuldade em lê-los.

Se seus ativos forem grandes, o problema pode ser um diferente, como uma perda de textura causada por arquivos super dimensionados. Isso é coberto em ativos super dimensionados e perda de textura.

#Certifique-se de que foi aplicado

Duas verificações:

1. Olhe para a linha em server.cfg. Um # principal a comenta, e um erro de digitação no nome significa que é ignorado. O nome é sv_enforceGameBuild, com aquela capitalização.
2. No cliente, use um pequeno script para imprimir o build em uso:

-- client.lua
CreateThread(function()
    Wait(5000)
    print('Game build: ' .. GetGameBuildNumber())
end)

Pressione F8 no jogo para ler o console. Deve imprimir o número que você definiu.

Se o build estiver errado, verifique se a linha está no server.cfg que realmente executa (o caminho está no topo do console txAdmin) e se você reiniciou o servidor em vez de um único recurso.

#Quando não é o build

Conteúdo faltando tem outras causas. Se o build está certo e um carro ou item de roupa ainda está faltando:

• O recurso não iniciou, ou iniciou com um erro.
• A pasta stream tem um arquivo no lugar errado, ou um nome errado.
• O fxmanifest.lua está faltando uma linha data_file que o ativo precisa.
• O cache do jogador é obsoleto. Veja limpando o cache do FiveM.

Para adicionar veículos corretamente, veja adicionando carros addon ao FiveM.

#Lista de verificação