Como ler um relatório de falhas de Minecraft

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

• crash-reports/
  Um ficheiro 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 registo de execução completo. Se não houver relatório de falha (o processo simplesmente terminou), o erro está aqui, no fim.
• logs/debug.log
  Um registo muito mais detalhado, útil quando o latest.log não o é o suficiente.

Num servidor, estas pastas ficam na raiz do servidor; num cliente, ficam dentro da pasta instance/.minecraft. Abra sempre o ficheiro mais recente por data e hora.

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

• Cabeçalho e descrição
  Uma linha Description que resume o que falhou, mais a hora. É 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 atribuída, 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, p. ex. «Exception ticking entity» ou «Unexpected error». Isso já lhe diz a categoria.
2. Encontre o tipo de exceção no topo do stack trace (p. ex. java.lang.OutOfMemoryError, NullPointerException, NoClassDefFoundError). O tipo muitas vezes nomeia o problema diretamente.
3. Vá ao último «Caused by:». Quando há vários encadeados, o mais profundo é normalmente a verdadeira causa raiz, não o primeiro.
4. Procure um nome de mod ou plugin no caminho do pacote (p. ex. com.somemod.Thing). Isso aponta diretamente para o culpado. Um stack trace puramente net.minecraft.* aponta antes 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 atribuída e percorra a lista de mods à procura de duplicados ou entradas desatualizadas.
6. Associe o sintoma a uma solução conhecida. Use a causa que encontrou para ir para 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 em falta. Veja NoClassDefFoundError.
• Exit code -1 with no crash report
  Leia o latest.log em vez disso. Veja Error Code -1.

Explore-os todos na página Problemas comuns .

Por vezes, o processo simplesmente termina (muitas vezes com código de saída 1 ou -1) sem escrever um relatório de falha. Nesse caso, o erro real está no fim de logs/latest.log. Percorra de baixo para cima até à primeira linha ERROR, FATAL ou Exception: foi aí que algo correu mal. Para perceber o próprio formato do registo, veja Entender os logs de Minecraft.