Entender os logs de Minecraft
Os logs de Minecraft são sua melhor fonte de verdade quando algo quebra. Eles registram o que o jogo ou o servidor fez, em ordem, até o momento da falha. Este guia explica quais arquivos de log importam, como ler uma linha de log e o que procurar.
Os arquivos de log que importam
Tudo fica na pasta logs/ (raiz do servidor, ou instance/.minecraft em um cliente):
- latest.log
O log completo da execução atual. É o arquivo que você abre primeiro; o erro está quase sempre aqui. - debug.log
Uma versão muito mais detalhada da mesma execução. Use-o quando o latest.log não disser o suficiente. - Logs arquivados
As execuções mais antigas são compactadas como2026-06-08-1.log.gz. Descompacte-o para ler uma sessão anterior. - crash-reports/
Uma pasta separada com um relatório focado, gravado apenas quando o jogo trava. Veja Como ler um relatório de falhas de Minecraft.
Como ler uma linha de log
Cada linha segue o mesmo formato:
[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
- [14:23:51]
A data e hora: quando o evento ocorreu. - [Server thread/ERROR]
A thread que o registrou, e o nível. - A mensagem
O que realmente aconteceu, muitas vezes seguido de um stack trace se for um erro.
O nível do log indica a gravidade num relance: INFO (normal), WARN (algo está errado mas não é fatal), ERROR (uma falha real), e FATAL (o servidor está sendo desligado).
Threads: quem está falando
- Server thread / main
O loop principal do jogo. Os erros aqui costumam afetar diretamente a jogabilidade (e podem travar o servidor). - Worker / IO threads
Trabalho em segundo plano como a E/S de chunks. Útil para problemas de disco e de salvamento do mundo. - Mod/plugin threads
Nomeado a partir de um mod ou plugin: uma dica rápida sobre o que é responsável.
O que procurar
- Vá até a primeira linha ERROR/FATAL ou Exception; os erros seguintes costumam ser apenas consequências.
- Leia a seção de inicialização em busca de mods/plugins com falha, da versão errada do Java ou de um EULA não aceito.
- Fique atento ao spam repetido de WARN como «Can't keep up!» (desempenho, veja Can't Keep Up) ou «moved too quickly».
- Anote as últimas linhas antes de um congelamento ou desligamento: mostram o que o servidor estava fazendo quando falhou.
- Cruze qualquer erro com a Problemas comuns lista para a solução exata.
Logs do servidor vs. logs do cliente
Eles compartilham o mesmo formato mas ficam em lugares diferentes. Um log de servidor registra o salvamento do mundo, as conexões dos jogadores e o carregamento de plugins/mods; um log de cliente registra a renderização, os pacotes de recursos e a sua própria conexão. Ao resolver um problema de conexão, compare os dois: a causa pode estar em apenas um lado.
Compartilhar logs com segurança
Os logs podem conter o IP do seu servidor e, ocasionalmente, tokens, então não os cole publicamente sem dar uma olhada primeiro. Use um serviço de paste (como o mclo.gs) para compartilhar, ou envie o arquivo diretamente para o MCDoctor.ai, que lê o log e explica a causa e a solução para você, sem garimpagem manual.
Perguntas frequentes
Na pasta logs/ na raiz do servidor ou na pasta instance/.minecraft. A execução atual é o latest.log; as anteriores são arquivos .log.gz compactados.
Eles cobrem a mesma execução, mas o debug.log é muito mais detalhado. Comece pelo latest.log e mude para o debug.log apenas quando precisar de mais detalhes.
WARN significa que algo está errado mas não é fatal; ERROR é uma falha real; FATAL significa que o servidor está desligando. Foque na primeira linha ERROR/FATAL.
Sim, envie o latest.log ou um relatório de falhas e o MCDoctor.ai o analisa e retorna a causa provável e a correção recomendada.