Tela de carregamento infinita do FiveM: guia de correção completo

Travamentos na tela de carregamento do FiveM ocorrem quando o handshake cliente-servidor falha, os recursos excedem a capacidade de streaming ou os caminhos de rede bloqueiam tráfego UDP essencial nas portas 30110-30125. Este guia fornece diagnósticos e correções sistemáticas para todas as três categorias de falhas.

Diagnóstico Imediato

Imprensa F8 durante o travamento para acessar o console:

Conectando ao servidor... Handshake com o servidor... Baixando conteúdo...

A fase travada determina o caminho de correção.

---

Escopo

Capas: Tempo limite de rede, falhas de streaming de recursos, corrupção de cache, loops de autenticação
Exclui: Falhas no servidor, problemas de instalação do jogo, falhas de hardware
Público-alvo: Administradores de servidor, desenvolvedores de mods, usuários avançados com acesso ao console

Métricas de Sucesso

• Conexão estabelecida em 60 segundos
• Todos os recursos carregados sem tempo limite
• O console não mostra nada AVISO: ou ERRO: entradas
• O tempo do quadro permanece <16 ms após o carregamento

Ferramentas necessárias

• Acesso administrativo ao Windows
• Console F8 habilitado
• Privilégios de diagnóstico de rede
• Editor de texto para arquivos de configuração

Prosseguir para a Inicial Seção de diagnóstico para resolução passo a passo.

Diagnóstico Inicial

1. Identifique o estágio de carregamento

Pressione F8 para abrir o console durante o carregamento. Verifique:

Carregado @resourcename/client.lua (xxx ms) Recurso iniciado resourcename Criando ambientes de script para resourcename

O último recurso carregado indica um ponto de falha.

2. Tempo limite de conexão vs. interrupção de recursos

Teste a conexão direta:

conectar servidorip:porta

Se for bem-sucedido, o problema está relacionado ao inicializador. Caso contrário, prossiga para o diagnóstico de rede.

Monitorar o carregamento de recursos:

-- Adicionar ao console do cliente resmon 1

Recursos usando >50 ms indicam problemas de otimização.

Soluções baseadas em rede

1. Correção de resolução de DNS

netsh int ip set dns "Conexão de área local" estático 8.8.8.8 netsh int ip add dns "Conexão de área local" 8.8.4.4 index=2

2. Otimização de MTU

Encontre a MTU ideal:

ping -f -l 1472 google.com

Diminua em 8 até obter sucesso e então defina:

netsh interface ipv4 definir subinterface "Ethernet" mtu=1492 armazenar=persistente

3. Requisitos de encaminhamento de porta

Configuração do roteador:

• TCP: 30120, 30110
• UDP: 30120, 30110
• Voz FiveM: UDP 30125

Correções do lado do cliente

1. Desabilite as otimizações de tela cheia

$fivemPath = "$env:LOCALAPPDATAFiveMFiveM.appFiveM.exe"
$bytes = [System.IO.File]::ReadAllBytes($fivemPath)
[System.IO.File]::WriteAllBytes($fivemPath, $bytes)
(Get-Item $fivemPath).Properties["Compatibility"].DisableFullscreenOptimizations = $true

2. Limpar tipos específicos de cache

:: Server-specific cache only
for /d %%i in ("%localappdata%FiveMFiveM.appdataserver-cache*") do rmdir /s /q "%%i"

:: Keep priv but clear everything else
move "%localappdata%FiveMFiveM.appdatacachepriv" "%temp%priv_backup"
rmdir /s /q "%localappdata%FiveMFiveM.appdatacache"
mkdir "%localappdata%FiveMFiveM.appdatacache"
move "%temp%priv_backup" "%localappdata%FiveMFiveM.appdatacachepriv"

3. Reconstrução do cache do shader

Excluir cache do shader DirectX:

rmdir /s /q "%localappdata%D3DSCache"
rmdir /s /q "%localappdata%NVIDIADXCache"
rmdir /s /q "%localappdata%AMDDxCache"

Problemas específicos do servidor

1. Problemas de streaming de recursos

Para servidores com arquivos MLO/YMAP grandes:

-- ajuste server.cfg definir sv_streamingTickRate 120 definir adhesive_cdnKey "sua_chave_cdn" definir sv_requestParanoia 0

2. Tempo limite de autenticação

-- Aumentar o tempo limite de conexão definido como sv_endpointprivacy false definido como sv_authMaxRetries 10 definido como sv_authMinTrust 5

3. Conflitos no sistema de filas

Desabilitar recursos de fila conflitantes:

# Verificar se há vários sistemas de filas grep -r "deferrals" resources/

Mantenha apenas um sistema de fila ativo.

Depuração Avançada

1. Análise de Rastreamento de Rede

netsh trace start capture=yes tracefile=fivem.etl provider=Microsoft-Windows-TCPIP level=5 :: Tentativa de conexão netsh trace stop

Analise com o Message Analyzer para perda de pacotes.

2. Ordem de carregamento de recursos

Criar __recurso.lua no recurso problemático:

dependência 'baseresource' client_script { '@baseresource/client.lua', 'client.lua' }

3. Problemas de alocação de memória

Para sistemas com mais de 16 GB de RAM:

-- citizen.ini na pasta FiveM.app [Jogo] DisableOSVersionCheck=1 PatchLethalForce=1 HeapAdjust=2048

Correções específicas da plataforma

Versão Steam:

reg add "HKLMSOFTWAREWow6432NodeRockstar GamesGTAV" /v "InstallFolder" /t REG_SZ /d "C:Program Files (x86)SteamsteamappscommonGrand Theft Auto V" /f

Versão da Epic Games:

Excluir %programdata%EpicEpicGamesLauncherDataManifests arquivos de cache.

Lançador Rockstar:

-verificar -modo de segurança

Prevenção de tempo limite

1. Pré-carregue ativos localmente

-- client.lua no recurso personalizado Citizen.CreateThread(function() RequestModel(`prop_cs_cardbox_01`) enquanto não HasModelLoaded(`prop_cs_cardbox_01`) faça Wait(0) end end)

2. Script de nova tentativa de conexão

:retry
start "" "%localappdata%FiveMFiveM.appFiveM.exe" +connect serverip:port
timeout /t 30
taskkill /f /im FiveM.exe
goto retry

Incertezas

• Windows 11 recursos de integridade de memória podem causar atrasos de carregamento não documentados
• Servidores protegidos pelo Cloudflare exigem verificação do navegador (nenhuma solução automatizada)
• Alguns ISPs limitam o tráfego UDP em portas não padronizadas de forma imprevisível

Referência de Padrões

• Protocolo de streaming CitizenFX v2.4.1
• RFC 4787 (Requisitos comportamentais NAT para UDP)

Conclusão: O congelamento da tela de carregamento geralmente ocorre devido a problemas no caminho da rede, cache corrompido ou gargalos no streaming de recursos do lado do servidor, exigindo isolamento sistemático.