Como diagnosticar o erro “Failed to Inflate” no FiveM

“Failed to Inflate” significa que não foi possível descomprimir os dados. Registre o erro completo e qualquer arquivo ou recurso mencionado antes de limpar o cache ou alterar configurações do servidor. A mesma mensagem pode ter causas diferentes.

Determine a abrangência

Se um jogador não consegue entrar enquanto outros entram normalmente, compare o download, o cache e o armazenamento desse cliente. Se vários jogadores falharem logo após o envio de um recurso, inspecione primeiro o pacote alterado no servidor. Uma única nova tentativa bem-sucedida não comprova que o pacote está íntegro.

Para o jogador afetado

1. Salve o erro, a referência da falha e o nome do servidor. Feche o FiveM completamente.
2. Verifique o espaço livre e se o problema ocorre em outro servidor. Reverta alterações gráficas recentes sem suporte se a falha começou com elas.
3. Se o erro indicar um download de recurso em cache, siga o guia de limpeza específica do cache e tente entrar nesse servidor novamente. Preserve as configurações e os arquivos não relacionados.
4. Envie à equipe o nome exato do recurso ou arquivo se a mesma falha voltar. Reinstalar o cliente inteiro não é a primeira etapa do diagnóstico.

Para o administrador do servidor

1. Faça backup do pacote e da configuração atuais. Compare o último recurso alterado com o arquivo original autorizado.
2. Verifique se houve uploads interrompidos, arquivos de zero bytes, arquivos ocultos omitidos ou documentos HTML e mensagens de erro salvos como downloads. Compare as somas de verificação quando disponíveis.
3. Reproduza o problema em homologação e isole o recurso indicado com suas dependências. Restaure a última versão funcional para testar se a regressão está no pacote.
4. Confira o manifesto do recurso, o formato dos assets e os requisitos de artifact. Teste novamente um novo download com mais de um cliente antes de implantar o pacote corrigido.

E os replays do cliente?

sv_disableClientReplays é uma configuração do servidor relacionada ao sistema de replay do cliente. Não é uma correção genérica de descompressão. Considere uma solução alternativa relacionada a replay somente quando o contexto da falha e a orientação atual do Cfx.re indicarem esse caminho; desativar replays também afeta os fluxos de gravação.

Não adicione variantes conflitantes de set e setr nem limpe todos os caches repetidamente para esconder um asset corrompido. Guarde a alteração exata, o procedimento de reinicialização e o resultado no registro do incidente.

Verifique a correção

Repita a mesma entrada e o mesmo local, incluindo um cliente sem o pacote anteriormente armazenado em cache. Inspecione o primeiro erro novo e restaure a versão anterior se a falha persistir. Use Solução de problemas do cliente Cfx.re e o referência de comandos de servidor para o ambiente de execução instalado.

Documentação de referência

Fonte: citizenfx/fivem