Como Depurar um Servidor FiveM Passo a Passo

Depure um problema do FiveM reproduzindo um sintoma, encontrando o primeiro erro relevante e alterando uma causa em um servidor de teste. Mantenha os últimos arquivos funcionando e o banco de dados correspondente disponíveis antes de mexer na produção.

Escolha a evidência certa

Uma falha apenas do cliente ou erro de UI precisa da saída F8 do jogador afetado e dos passos de reprodução. Uma saída de processo do servidor precisa dos logs do FXServer/host e de qualquer referência de falha. Uma entrada lenta precisa de tempo por estágio; FPS baixo precisa de evidência de tempo de quadro do cliente. Vários jogadores com lag juntos podem precisar de medições de servidor e rede.

Registre o horário UTC, jogadores afetados, localização, ação, artefato, versões de framework/recurso e mudanças recentes. Remova credenciais e identificadores pessoais dos logs compartilhados.

Leia o primeiro erro

Use seu ambiente de lançamento real: console txAdmin e seus logs configurados, um diário de serviço ou saída de processo redirecionada. Não há um caminho universal server-data/server.log para cada instalação.

Leia o primeiro erro envolvendo o recurso, incluindo seu arquivo, linha e rastreamento de pilha. Exportações ausentes posteriores podem ser consequências de uma dependência anterior falha. Para um valor nulo, inspecione o produtor do valor e o caminho de retorno em vez de inserir um padrão cegamente.

Reproduza com segurança

1. Crie uma cópia isolada com configuração representativa e dados de teste. Confirme se o erro ainda ocorre lá.
2. Verifique dependências, nomes exatos de pastas e ordem de inicialização antes de editar a lógica. Em um host sensível a maiúsculas e minúsculas, a capitalização do caminho do arquivo importa.
3. Reduza a reprodução ao menor conjunto de recursos afetados, preservando as dependências necessárias. Desative um suspeito por vez.
4. Aplique uma correção direcionada, repita a ação original e teste o caminho de falha relevante com um jogador sem privilégios.
5. Reconecte, reinicie o recurso e execute uma reinicialização completa do servidor. Mantenha a correção apenas se a persistência e as permissões permanecerem corretas.

Use diagnósticos para seu propósito real

O referência de comandos de servidor documents refresh, ensure and restart. These can disrupt active resource state; use them on staging or in a coordinated maintenance window.

se_debug true habilita o log de ACL/segurança, não um modo de depuração de script geral. Desative-o com se_debug false após a investigação de permissão. Um set debug_mode true personalizado não tem efeito a menos que um recurso leia explicitamente essa convar.

Consulte profiler para execução de script. Resmon é do lado do cliente e não relata o tempo de consulta do banco de dados ou o custo total da GPU.

Escalone com um relatório útil

Inclua o comportamento esperado versus o real, os passos exatos de reprodução, o primeiro erro completo, as versões relevantes e o que mudou. Forneça um pequeno trecho de configuração com segredos removidos. Mantenha os despejos de recursos não relacionados e os dados do jogador privados.

Se o problema de produção piorar, restaure o último recurso/configuração aceito. Restaure um banco de dados apenas quando necessário e após contabilizar o progresso mais recente do jogador.