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
- Registre o servidor exato, a hora, o texto de carregamento e qualquer erro visível.
- 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.
- Tente entrar em outro servidor que você sabe que funciona. Se isso também falhar, siga exatamente as orientações atuais da Cfx.re sobre problemas do cliente.
- Reinicie o FiveM e o Windows uma vez para liberar processos bloqueados.
- 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
- Congele as implantações e exporte o log relevante do FXServer/txAdmin em torno de uma conexão falha.
- Verifique se o problema começou imediatamente após uma alteração de recurso, artefato, configuração ou banco de dados.
- 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.
- Verifique os serviços necessários e o acesso ao banco de dados sem imprimir credenciais.
- 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 travar o processo de entrada quando espera indefinidamente por um export, resultado do banco de dados, objeto do framework ou evento do cliente. Procure no log do servidor mensagens como “could not find dependency”, erros de análise e tempos limite excedidos. Defina explicitamente a ordem de inicialização com dependency no fxmanifest.lua ou uma sequência correta de ensure; não esconda a falha com pausas arbitrárias.
Em um servidor de desenvolvimento, refresh verifica novamente os manifests e ensure resource-name inicia ou reinicia um recurso. Esses comandos são definidos na referência oficial de comandos do servidor. Evite reiniciar uma dependência em 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 valores de segurança
sv_*não documentados de um guia sobre outro erro. - 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.