Como usar o profiler do FiveM para encontrar scripts que causam lag

Passo 1: Primeiro, reproduza o problema

Anote o horário, a quantidade de jogadores e a ação que antecede o travamento: abrir inventário, entrar numa área, salvar um veículo ou reiniciar um resource. Diferencie queda de FPS no cliente de hitch no servidor. O profiler funciona nos dois lados, mas uma captura do cliente não mede diretamente o processamento do FXServer. Mantenha os artifacts atualizados conforme a documentação da Cfx.re.

Passo 2: Grave uma amostra no console do servidor

No console do FXServer, execute profiler record 500 como ponto de partida indicado pela documentação. Use profiler status para acompanhar a gravação. Capture durante uma sessão representativa, de preferência no momento da lentidão, e registre também logs e consumo de CPU e RAM. Uma amostra feita com a cidade vazia pode esconder o problema que aparece no horário de pico.

1. Reproduza a ação que causa o lag com jogadores de teste.
2. Execute profiler record 500 no console do servidor.
3. Confira o término com profiler status.
4. Repita a captura após uma mudança para comparar condições semelhantes.

Passo 3: Leia os picos antes de culpar o hardware

Abra o resultado com profiler view; no servidor, copie o endereço fornecido para o navegador. Se preferir guardar a captura, use profiler saveJSON nome.json e carregue o arquivo na aba Performance das ferramentas do Chrome. Procure picos de tempo de CPU e abra as chamadas até encontrar o resource e a função. O perfil mostra onde investigar; ele não corrige o script automaticamente.

Passo 4: Isole a causa e valide a correção

Revise loops frequentes, consultas ao banco, eventos disparados em massa e recursos recém-instalados. Desative somente em ambiente de teste aquilo que pode interromper a cidade; faça backup antes. Se o perfil melhorar, verifique se a função do resource continua correta. Quando vários processos disputam CPU ou falta memória, compare as métricas da VPS sob a mesma carga antes de pensar em upgrade.