RealisticNode Docs
Solução de problemas

Leia Logs e Crash Reports

Encontre e leia os logs e crash reports do seu servidor de Minecraft na RealisticNode, entenda os stack traces, compartilhe logs e descubra qual plugin ou mod está com problema.

Quando algo dá errado, seu servidor quase sempre anota o motivo. Este guia mostra onde encontrar essa informação e como lê-la, mesmo que você nunca tenha visto um erro de Java antes.

Onde encontrar os logs

Abra Files no painel. Estes são os arquivos e pastas que importam:

Arquivo ou pastaO que tem dentro
logs/latest.logTudo o que o servidor mostrou desde a última inicialização. É o primeiro arquivo a conferir.
logs/*.log.gzLogs mais antigos, um por dia ou por inicialização (por exemplo 2026-10-24-1.log.gz). Eles ficam compactados.
crash-reports/Um arquivo .txt por crash, com a data e a hora no nome. Abra o mais recente.
logs/debug.logSó no Forge e no NeoForge. Bem mais detalhado que o latest.log, útil quando um mod não carrega.
hs_err_pid*.logNa pasta principal. Criado quando o próprio Java trava (raro).

O latest.log é substituído a cada inicialização. Se o problema aconteceu antes de um reinício, procure no arquivo .log.gz mais recente.

Abra um log mais antigo

Os logs mais antigos terminam em .gz, então você não consegue abri-los direto no navegador. Você pode:

  • Clicar com o botão direito no arquivo e escolher Unarchive: o arquivo .log normal aparece na mesma pasta. Clique nele para ler.
  • Ou escolher Download e abrir no seu computador com o 7-Zip (Windows) ou o Utilitário de Compressão (Mac).

Arquivos com mais de 4 MB não abrem no editor do navegador: baixe-os ou use SFTP.

Use o console

O Console mostra a mesma saída do latest.log em tempo real.

  • Clique em Error ou Warning acima da saída para esconder todo o resto. É o jeito mais rápido de achar problemas numa inicialização longa.
  • Aperte Ctrl + F dentro da saída para pesquisar uma palavra, como o nome de um plugin.
  • Clique no ícone Share Logs para enviar as últimas 500 linhas para o mclo.gs. O link é copiado para você, pronto para mandar para a nossa equipe. O mclo.gs também destaca os erros e dá dicas.

Logs compartilhados são públicos

Qualquer pessoa com o link pode ler o log. Confira se ele não mostra senhas, dados de banco de dados, tokens de API ou endereços IP que você quer manter privados.

Como ler um erro

Os erros de Java parecem assustadores, mas você só precisa de algumas linhas. Veja um exemplo típico:

logs/latest.log
[12:04:31 ERROR]: Error occurred while enabling ShopPlus v2.3 (Is it up to date?)
java.lang.IllegalStateException: Could not load the shop list
    at com.example.shopplus.config.ShopConfig.load(ShopConfig.java:42)
    at com.example.shopplus.ShopPlus.onEnable(ShopPlus.java:18)
    at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:288)
    ...
Caused by: java.io.FileNotFoundException: plugins/ShopPlus/shops.yml (No such file or directory)
    at java.io.FileInputStream.open0(Native Method)
    ...

Leia a primeira linha

Muitas vezes ela já diz o que falhou: aqui, o plugin ShopPlus não conseguiu iniciar.

Encontre as linhas "Caused by"

Um erro longo pode ter várias linhas Caused by:. A última normalmente é o motivo real. Aqui, falta um arquivo.

Olhe os nomes dos pacotes

As linhas at ... mostram onde o erro aconteceu. Pule as que começam com java., net.minecraft., org.bukkit., io.papermc. ou net.minecraftforge. (esse é o jogo e o software do servidor). O primeiro nome diferente, como com.example.shopplus, aponta para o plugin ou mod responsável.

Pesquise o erro

Copie a linha do erro (sem a hora) e pesquise junto com o nome do plugin ou do mod. Muitas vezes alguém já teve o mesmo problema. Confira também se há uma versão mais nova na página do plugin ou do mod.

Leia um crash report

Os crash reports em crash-reports/ seguem a mesma ideia. Olhe:

  • Description: um resumo curto, como Ticking entity ou Exception in server tick loop.
  • O erro e as linhas Caused by logo abaixo dele.
  • Seções como -- Entity being ticked -- ou -- Block entity being ticked --: elas mostram o tipo e a localização da coisa que travou.
  • No Forge e no NeoForge, alguns relatórios listam Suspected Mods (mods suspeitos). É uma boa pista, mas nem sempre está certa.

A página Erros comuns explica as mensagens que você vai ver com mais frequência.

Encontre um plugin ou mod com problema dividindo pela metade

Se os logs não apontam um culpado, teste metade dos seus plugins ou mods de cada vez. Com 40 mods, você encontra o problemático em uns 6 reinícios.

Faça um backup antes

Crie um backup antes de remover qualquer coisa. Alguns mods apagam do mundo os blocos e itens deles quando estão faltando.

Tire metade deles

Pare o servidor. Em Files, crie uma pasta chamada disabled na pasta principal e use Move para levar metade dos arquivos .jar de plugins (ou mods) para dentro dela.

Teste

Inicie o servidor. Se o problema sumiu, o culpado está na pasta disabled. Se continua, está na metade que ficou.

Repita

Continue dividindo o grupo suspeito pela metade até sobrar só um arquivo. Depois atualize esse arquivo, procure uma alternativa ou reporte o bug ao autor, e mova os outros arquivos de volta.

Mantenha as bibliotecas junto com os mods que precisam delas (por exemplo Fabric API, Architectury ou Cloth Config). Se não, você vai receber erros de "missing dependency" (dependência faltando) que escondem o problema real.

Precisa de ajuda?

Clique em Share Logs no console, ou envie o crash report para o mclo.gs, e mande o link para a nossa equipe no Discord com o seu Server ID e o que mudou antes de o problema começar.

Nesta página