Onde Encontrar os Logs do Hytale e Como Analisá-los

1. Reproduza o problema de forma controlada

Antes de abrir os arquivos, anote a ação que causa a falha e o horário aproximado. Quando possível, reinicie, execute somente a ação problemática e pare. Isso reduz o ruído de sessões antigas.

Não repita dezenas de vezes. As tentativas podem encher o final do log e esconder o primeiro stack trace útil.

2. Abra os locais oficiais dos logs

O guia oficial lista pastas do cliente por plataforma e uma pasta logs dentro de cada mundo salvo para o servidor local. Use o arquivo mais novo que corresponda ao horário do teste.

Em servidores hospedados, o painel pode expor os mesmos arquivos. Baixe o texto original em vez de copiar somente uma captura de tela.

• Cliente no Windows: %APPDATA%\Hytale\UserData\logs
• Servidor do mundo no Windows: %APPDATA%\Hytale\UserData\Saves\[mundo]\logs
• Cliente no macOS: ~/Library/Application Support/Hytale/UserData/logs
• Cliente no Linux: ~/.local/share/Hytale/UserData/logs

3. Escolha a sessão correta e preserve o original

Ordene por data de modificação e compare os horários dentro do arquivo. Faça uma cópia antes de cortar ou anotar. Compactar ajuda em arquivos grandes, mas mantenha um trecho em texto para revisão rápida.

Inclua o log do cliente quando ele trava ou não consegue entrar. Inclua o do servidor em falhas de inicialização, mundo, comandos, mods ou quando todos são afetados. Às vezes os dois são necessários.

4. Encontre a primeira falha relevante

Pesquise por ERROR, WARN, exception, failed, caused by ou timeout. Depois suba e leia as linhas anteriores. Mensagens de inicialização revelam qual componente estava carregando quando a falha começou.

Um warning não é automaticamente a causa. Dê mais peso a uma exceção clara, falha repetida ligada ao sintoma ou ao primeiro erro após a ação problemática.

5. Leia o stack trace sem adivinhar

Comece na mensagem da exceção e procure a cadeia 'caused by'. A causa mais profunda costuma descrever o problema concreto, enquanto as linhas superiores mostram o caminho até ele.

Pacotes, mods, caminhos, chaves e IDs são pistas, não provas isoladas. Confirme reproduzindo após reverter uma alteração relevante por vez.

6. Use o Analisador de Logs do HyTools

Cole ou importe o log no analisador. Ele destaca severidades, organiza linhas úteis, permite navegar por ocorrências e ajuda a montar um relatório compacto. O processamento acontece localmente no navegador.

Use filtros para reduzir ruído visual, mas volte ao contexto sem filtro antes de concluir. Copie o bloco com várias linhas antes e depois da falha.

7. Prepare um relatório que possa ser resolvido

Um bom relatório informa resultado esperado, o que aconteceu, passos exatos, horário, versão, sistema, mudanças recentes e o trecho ou arquivo de log relevante.

Evite títulos como 'deu erro'. Descreva a ação afetada: 'servidor para ao carregar o mundo depois de adicionar o mod X'.

1. 1

   Escreva o problema em uma frase.

2. 2

   Liste a menor sequência para reproduzir.

3. 3

   Registre versões e mudanças recentes.

4. 4

   Anexe o original de forma privada quando necessário.

5. 5

   Cole um trecho curto e revisado.

6. 6

   Informe o que você já testou.

8. Compartilhe logs com segurança

Logs podem conter nomes de usuário, pastas locais, endereços, autenticação e dados de plugins. Pesquise antes de publicar e oculte apenas valores sensíveis, preservando o contexto técnico.

Ao reportar em um canal oficial ou confiável, siga as instruções de envio. Não altere o arquivo original guardado para investigação.