Como ler um relatório de falhas de Minecraft

O Minecraft grava um relatório de falha sempre que o jogo ou o servidor para inesperadamente. Veja aqui:

• crash-reports/
  Um arquivo com data e hora como crash-2026-06-08_14.23.51-server.txt. Este é o relatório dedicado e detalhado.
• logs/latest.log
  O log de execução completo. Se não houver relatório de falha (o processo simplesmente encerrou), o erro está aqui, no final.
• logs/debug.log
  Um log muito mais detalhado, útil quando o latest.log não é detalhado o suficiente.

Em um servidor, essas pastas ficam na raiz do servidor; em um cliente, ficam dentro da pasta instance/.minecraft. Sempre abra o arquivo mais recente por data e hora.

Todo relatório tem as mesmas partes, de cima para baixo:

• Cabeçalho e descrição
  Uma linha Description que resume o que falhou, mais o horário. É a sua primeira pista.
• O stack trace
  O tipo de exceção, depois uma lista de linhas de código que mostram onde aconteceu, muitas vezes seguida de um ou mais blocos Caused by: .
• Nível / detalhes afetados
  Para falhas de mundo ou de entidade: as coordenadas, a dimensão e a entidade/o bloco envolvidos.
• Detalhes do sistema
  Versão do Minecraft, versão do Java, memória alocada, o carregador de mods e a lista completa de mods. Ouro para o diagnóstico.

1. Leia a linha Description. É um resumo em linguagem simples, por ex. «Exception ticking entity» ou «Unexpected error». Isso já indica a categoria.
2. Encontre o tipo de exceção no topo do stack trace (por ex. java.lang.OutOfMemoryError, NullPointerException, NoClassDefFoundError). O tipo muitas vezes nomeia o problema diretamente.
3. Vá até o último «Caused by:». Quando há vários encadeados, o mais profundo costuma ser a verdadeira causa raiz, não o primeiro.
4. Procure um nome de mod ou plugin no caminho do pacote (por ex. com.somemod.Thing). Isso aponta diretamente para o culpado. Um stack trace puramente net.minecraft.* aponta, em vez disso, para dados vanilla/do mundo.
5. Verifique os detalhes do sistema. Confirme que a versão do Java corresponde à sua versão do Minecraft, veja quanta memória foi alocada e percorra a lista de mods em busca de duplicatas ou entradas desatualizadas.
6. Associe o sintoma a uma solução conhecida. Use a causa que você encontrou para ir até a solução correspondente (veja os exemplos abaixo).

• OutOfMemoryError: Java heap space
  Memória insuficiente. Veja Out of Memory.
• Exception ticking entity
  Uma única entidade corrompida. Veja Ticking Entity.
• A single server tick took 60.00 seconds
  O servidor congelou. Veja Watchdog Crash.
• NoClassDefFoundError / ClassNotFoundException
  Uma biblioteca ausente. Veja NoClassDefFoundError.
• Exit code -1 with no crash report
  Leia o latest.log em vez disso. Veja Error Code -1.

Explore todos eles na página Problemas comuns .

Às vezes o processo simplesmente encerra (muitas vezes com código de saída 1 ou -1) sem gravar um relatório de falha. Nesse caso, o erro real está no final de logs/latest.log. Role de baixo para cima até a primeira linha ERROR, FATAL ou Exception: foi aí que algo deu errado. Para entender o próprio formato do log, veja Entender os logs de Minecraft.