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 num cliente):
- latest.log
O registo completo da execução atual. É o ficheiro que 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. - Registos arquivados
As execuções mais antigas são compactadas como2026-06-08-1.log.gz. Descompacte-o para ler uma sessão passada. - crash-reports/
Uma pasta separada com um relatório focado, escrito apenas quando o jogo falha. 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 registou, 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 registo indica a gravidade num relance: INFO (normal), WARN (algo está mal mas não é fatal), ERROR (uma falha real), e FATAL (o servidor está a desligar-se).
Threads: quem está falando
- Server thread / main
O ciclo principal do jogo. Os erros aqui costumam afetar diretamente a jogabilidade (e podem fazer o servidor falhar). - Worker / IO threads
Trabalho em segundo plano como a E/S de chunks. Útil para problemas de disco e de gravação do mundo. - Mod/plugin threads
Com o nome de um mod ou plugin: uma pista rápida sobre o que é responsável.
O que procurar
- Vá para a primeira linha ERROR/FATAL ou Exception; os erros seguintes são muitas vezes apenas consequências.
- Leia a secção de arranque à procura de mods/plugins falhados, da versão errada do Java ou de um EULA não aceite.
- Esteja 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 encerramento: mostram o que o servidor estava a fazer quando falhou.
- Cruze qualquer erro com a Problemas comuns lista para a solução exata.
Logs do servidor vs. logs do cliente
Partilham o mesmo formato mas ficam em locais diferentes. Um registo de servidor regista a gravação do mundo, as ligações dos jogadores e o carregamento de plugins/mods; um registo de cliente regista a renderização, os pacotes de recursos e a sua própria ligação. Ao resolver um problema de ligação, compare ambos: a causa pode estar apenas de um lado.
Compartilhar logs com segurança
Os registos podem conter o IP do seu servidor e, ocasionalmente, tokens, por isso não os cole publicamente sem dar uma vista de olhos primeiro. Use um serviço de paste (como o mclo.gs) para partilhar, ou carregue o ficheiro diretamente para o MCDoctor.ai, que lê o registo e lhe explica a causa e a solução, sem escavação 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.