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 como 2026-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

  1. Vá até a primeira linha ERROR/FATAL ou Exception; os erros seguintes costumam ser apenas consequências.
  2. 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.
  3. Fique atento ao spam repetido de WARN como «Can't keep up!» (desempenho, veja Can't Keep Up) ou «moved too quickly».
  4. Anote as últimas linhas antes de um congelamento ou desligamento: mostram o que o servidor estava fazendo quando falhou.
  5. 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.