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

  1. Vá para a primeira linha ERROR/FATAL ou Exception; os erros seguintes são muitas vezes apenas consequências.
  2. Leia a secção de arranque à procura de mods/plugins falhados, da versão errada do Java ou de um EULA não aceite.
  3. Esteja 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 encerramento: mostram o que o servidor estava a fazer quando falhou.
  5. 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.