Carro crashando no FiveM: como achar o arquivo que derruba o jogo e reparar sem refazer o mod

O player spawna o carro e o jogo fecha. Ou pior: fecha para quem está em volta, e aí sobra reclamação no Discord. Crash de asset tem causa específica, dá para isolar sem chutar e, em boa parte dos casos, dá para reparar sem refazer o mod. Este guia mostra o método e o padrão técnico que mais aparece.

Crash de script e crash de asset: como diferenciar pelo sintoma

Antes de caçar arquivo, separe os dois mundos. Eles se parecem para quem está jogando e não se parecem nada para quem vai resolver.

• Crash de script. Aparece no resmon, costuma travar o servidor ou derrubar todo mundo junto, e tem rastro no console do servidor.
• Crash de asset. O servidor continua vivo e só o cliente fecha, sempre ligado a uma ação concreta: spawnar um modelo, chegar perto de um lugar, trocar de roupa.

Se o console do servidor segue imprimindo normalmente enquanto o player fecha, o problema está num arquivo de stream. É esse o caso deste guia.

Os sintomas clássicos

Crash de asset é previsível. O gatilho quase sempre denuncia a categoria do arquivo:

• Fecha ao spawnar um veículo. Modelo ou textura do carro.
• Fecha ao chegar perto de um ponto do mapa. MLO ou prop daquele lugar.
• Fecha ao trocar de roupa ou abrir a loja. Peça de roupa, quase sempre num pack recém-instalado.
• Fecha na hora de mostrar uma arma ou acessório. Prop pequeno com textura remontada errada.

Como isolar o resource e depois o arquivo

O método é chato mas termina. A ideia é dividir sempre pela metade, em vez de testar arquivo por arquivo.

Comece pelo que mudou. Crash que apareceu do nada quase nunca é do nada: ou entrou mod novo, ou um pack foi atualizado. Se você sabe o que mudou, o trabalho vira minutos.

1. Reproduza o crash e anote o gatilhoDescubra a ação exata que fecha o jogo: spawnar um modelo, entrar num lugar, trocar de roupa. O gatilho aponta a categoria do arquivo.
2. Desligue o resource suspeitoComece pelo que entrou ou foi atualizado por último. Se o crash para, o culpado está dentro dele.
3. Divida os arquivos de stream em metadesTire metade dos arquivos da pasta de stream e teste. Repita a divisão na metade que continuar quebrando, até sobrar um punhado de arquivos.
4. Passe os arquivos pela validaçãoEnvie os suspeitos para o otimizador ou, se for veículo, abra no Studio. A varredura aponta o padrão que derruba o jogo e o arquivo exato.
5. Aplique o reparo ou substitua o arquivoReparo determinístico volta o arquivo utilizável. Sem reparo seguro, use o original, peça a correção ao criador ou troque o mod.
6. Teste com mais de um playerCrash de asset depende do que está carregado em volta. Confirme com duas ou três pessoas na mesma área antes de considerar resolvido.

O que dentro do arquivo derruba o jogo

O padrão que mais encontramos é uma textura que mente sobre o próprio formato. O cabeçalho diz um formato que exige, por exemplo, 4 bytes por pixel, mas os dados ali dentro são de um formato comprimido, que ocupa uma fração disso.

Nada acontece enquanto o arquivo está parado. O problema aparece na hora de subir a textura para a placa de vídeo: o motor calcula quantos bytes precisa ler pela regra do formato declarado, lê além do que existe no buffer e o processo morre. Do lado do player, o jogo simplesmente fecha.

Esse foi exatamente o caso que fechou uma investigação nossa de crash em roda de carro: a textura declarava um formato de 4 bytes por pixel e carregava os bytes de um formato comprimido. O arquivo abria em ferramenta, passava batido em conferência de tamanho e derrubava quem estava por perto.

Por que o OpenIV abre o arquivo e o jogo ainda cai

Abrir não é validar. Ferramentas de edição leem o cabeçalho, montam a lista de texturas e mostram o que encontram. Elas não simulam o carregamento na GPU.

O jogo faz o contrário: confia no cabeçalho e lê cada byte. Um arquivo com cabeçalho coerente e conteúdo insuficiente passa na ferramenta e falha no jogo. É por isso que o teste do OpenIV, do CodeWalker ou de qualquer visualizador não serve de garantia.

Validação de crash: varrer os padrões e reparar de forma determinística

No Texturize, todo arquivo que entra passa por uma varredura desses padrões antes de qualquer coisa, e o mesmo vale para o que sai. Isso está no ar desde 26/08.

Quando o reparo é determinístico, ele é aplicado: se os bytes reais batem exatamente com o layout de um formato comprimido, o rótulo é corrigido para esse formato e o jogo para de ler fora do buffer, sem mudar um pixel da imagem. Quando não há reparo seguro, o arquivo não é entregue: ele fica fora do zip e o relatório explica o motivo.

Tem uma trava a mais no caminho de volta: se a operação introduzir um risco que o arquivo aberto não tinha, nada é salvo e nada é cobrado. O crédito conta arquivo devolvido, então arquivo recusado não vira cobrança.

Quando o reparo não é possível

Existe o caso em que o arquivo está corrompido além do rótulo: dados truncados, dicionário inconsistente, geometria apontando para vértice que não existe. Aí o caminho é outro.

• Fale com quem criou o mod. Mostre o motivo que o relatório deu. Criador sério conserta e agradece o report.
• Volte o original. Se o arquivo quebrado veio de uma edição sua, o original resolve na hora.
• Troque o mod. Nenhum carro vale derrubar a cidade num evento cheio.

Se o arquivo é de veículo e você quer editar antes de subir, dá para abrir o carro no Studio e ver o modelo em 3D, peça por peça, antes de publicar. Vale ler também o guia do add-on de veículo: carro que não spawna é um problema diferente de carro que derruba o jogo, e a confusão entre os dois faz gente reinstalar mod sem necessidade.

Como prevenir

Crash de asset é o tipo de problema que custa caro depois e é barato antes. Duas regras bastam:

• Nenhum mod entra sem passar pela validação. Vale para pack comprado, pack de amigo e arquivo editado por você.
• Arquivo editado é arquivo novo. Toda vez que uma textura é trocada na mão, existe a chance de o dicionário sair inconsistente. Passar pela validação depois da edição fecha essa porta.

Se o que motivou a busca foi peso e não crash, o caminho é o aviso de physical memory, que é aviso de orçamento, não de arquivo inválido.