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 pasta | O que tem dentro |
|---|---|
logs/latest.log | Tudo o que o servidor mostrou desde a última inicialização. É o primeiro arquivo a conferir. |
logs/*.log.gz | Logs 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.log | Só no Forge e no NeoForge. Bem mais detalhado que o latest.log, útil quando um mod não carrega. |
hs_err_pid*.log | Na 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
.lognormal 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:
[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 entityouException 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.
Lag e Desempenho
Encontre e resolva o lag no seu servidor de Minecraft. Meça o TPS com o spark, otimize o Paper, pré-gere o mundo com o Chunky e reduza a distância de visão.
Erros Comuns de Servidor de Minecraft
O que significam os erros mais comuns de servidor de Minecraft e como resolvê-los na RealisticNode, de "Can't keep up" e ticking entity a erros de porta, login e plugins.