Tela de Carregamento Infinita do FiveM: Diagnóstico e Correções

Quando o FiveM permanecer em uma tela de carregamento, primeiro determine se a falha afeta um cliente, um servidor ou todos os jogadores após uma alteração de recurso. Preserve o texto exato da tela e o erro do console, teste um servidor que você sabe que está funcionando e altere uma causa reversível por vez. Não comece com convars de segurança não documentados ou uma exclusão geral de dados do aplicativo e do servidor.

Classifique a falha antes de alterar arquivos

Escopo observado	Comece aqui
Um jogador, múltiplos servidores	Processo do cliente, problema oficial do cliente, instalação do GTA/FiveM e diagnóstico do cache local.
Um jogador, um servidor	Erro F8, caminho de conexão e o primeiro recurso ou download que falha para esse cliente.
Todos os jogadores em um servidor	Console FXServer/txAdmin, implantação recente, inicialização de recursos e integridade do banco de dados/dependências.
Somente após alterar uma tela de carregamento personalizada	Manifesto da tela de carregamento, console do navegador e ciclo de vida de desligamento manual.

Verificações do lado do jogador

1. Registre o servidor exato, a hora, o texto de carregamento e qualquer erro visível.
2. Pressione F8 e capture o primeiro erro relevante em vez das linhas repetidas que o seguem. O Cfx.re documenta o F8 em sua referência do console do cliente.
3. Tente outro servidor conhecido e funcional. Se isso também falhar, siga as orientações exatas atuais do Cfx.re sobre problemas do cliente.
4. Reinicie o FiveM e o Windows uma vez para liberar processos bloqueados.
5. Se a evidência apontar para ativos de servidor em cache, use o procedimento reversível no guia de cache do FiveM. Não exclua o diretório inteiro de dados do aplicativo.

Verificações do proprietário do servidor

1. Congele as implantações e exporte o log relevante do FXServer/txAdmin em torno de uma conexão falha.
2. Verifique se o problema começou imediatamente após uma alteração de recurso, artefato, configuração ou banco de dados.
3. Use o Console ao Vivo e os controles de recursos do txAdmin para identificar a primeira dependência com falha. O txAdmin é empacotado com o FXServer e seus recursos atuais de monitoramento são documentados no guia oficial do txAdmin.
4. Verifique os serviços necessários e o acesso ao banco de dados sem imprimir credenciais.
5. Reverta a última alteração realizada ou desative apenas o recurso isolado em uma instância de desenvolvimento.

Verifique a inicialização e as dependências dos recursos

Um recurso pode bloquear a entrada do jogador ao esperar indefinidamente por um export, resultado do banco de dados, objeto do framework ou evento do cliente. Procure no log do servidor a mensagem “could not find dependency”, erros de análise e timeouts. Defina explicitamente a ordem de inicialização com dependency em fxmanifest.lua ou uma ensure sequência correta; não oculte a falha com sleeps arbitrários.

Em um servidor de desenvolvimento, refresh reanalisa os manifestos e ensure resource-name inicia ou reinicia um recurso. Esses comandos são definidos na referência de comandos do servidor referência de comandos de servidoroficial. Evite reiniciar uma dependência de produção sem entender quais sessões ativas a utilizam.

Falhas na tela de carregamento personalizada

Se o jogo estiver pronto, mas uma tela personalizada nunca fechar, verifique se o recurso usa loadscreen_manual_shutdown 'yes'. Esse modo exige que um script do cliente chame ShutdownLoadingScreenNui() após uma condição real de pronto. Remova a diretiva de desligamento manual para retornar ao comportamento automático durante a depuração. O ciclo de vida e os eventos de progresso suportados estão documentados no guia de tela de carregamento do Cfx.re.

Evite correções genéricas inseguras

• Não copie sv_* valores de segurança não documentados de um guia de erros não relacionado.
• Não desative permanentemente a proteção antivírus ou firewall.
• Não exclua um banco de dados ativo, o diretório de dados do txAdmin ou a instalação completa do FiveM antes de preservar um backup.
• Não adicione novas tentativas repetidas do cliente que concedam itens, dinheiro ou permissões mais de uma vez.
• Não chame um tempo limite de carregamento mais longo de correção quando o recurso subjacente ainda falhar.

Verifique a correção

Repita a mesma conexão no cliente afetado, um segundo cliente limpo e após uma reinicialização completa do servidor. Confirme que o primeiro erro do console desapareceu, o jogador atinge um estado utilizável, os recursos necessários foram iniciados uma vez e nenhuma ação duplicada de direito ou inventário ocorreu. Mantenha o rollback até que o resultado sobreviva à reinicialização.