Lendo os logs do servidor para resolver problemas
"O servidor não liga." "O plugin não funciona." "Crashou do nada." Em quase todos os casos, a resposta está nos logs. Saber lê-los economiza horas.
Onde estão os logs
logs/latest.log— log da execução atual;logs/AAAA-MM-DD-N.log.gz— logs anteriores, compactados;crash-reports/— relatórios detalhados quando o servidor trava (comum em servidores com mods).
Acesse pelo gerenciador de arquivos do painel ou baixe por SFTP.
Anatomia de uma linha
[14:32:10 WARN]: [EssentialsX] Could not load config.yml14:32:10— horário;WARN— nível (INFO, WARN, ERROR);[EssentialsX]— quem gerou a mensagem;- O restante — a mensagem.
Entendendo um stack trace
Erros graves vêm acompanhados de um stack trace, várias linhas começando com at ...:
[ERROR]: Error occurred while enabling MeuPlugin v1.0
java.lang.NoClassDefFoundError: net/exemplo/Dependencia
at com.meuplugin.Main.onEnable(Main.java:42)
...
Caused by: java.lang.ClassNotFoundException: net.exemplo.DependenciaDicas:
- Leia a primeira linha do erro — ela diz o tipo (
NoClassDefFoundError); - Procure o
Caused by:mais abaixo — geralmente é a causa real; - Procure nomes de plugins ou mods nas linhas
at— indicam quem está envolvido.
Erros comuns e o que significam
| Mensagem | Significado provável |
|---|---|
UnsupportedClassVersionError |
Versão do Java incompatível com o servidor/plugin |
NoClassDefFoundError / ClassNotFoundException |
Falta uma dependência (outro plugin/mod) ou versão errada |
Could not load 'plugins/X.jar' |
Plugin incompatível com a versão do servidor ou corrompido |
Can't keep up! Is the server overloaded? |
Servidor atrasado — TPS baixo |
OutOfMemoryError |
Falta memória para o servidor |
Failed to bind to port |
Porta já em uso ou incorreta |
You need to agree to the EULA |
eula.txt não foi aceito |
Mod X requires Y |
Dependência de mod ausente ou versão incompatível |
Mixin apply failed |
Conflito ou incompatibilidade entre mods |
Crash reports (servidores com mods)
Abra o arquivo mais recente em crash-reports/ e procure:
- "Description:" — resumo do erro;
- A seção "-- Head --" e o stack trace, onde geralmente aparece o mod culpado;
- A lista de mods carregados, para conferir versões.
Compartilhando logs para pedir ajuda
Use serviços como mclo.gs, feitos para logs de Minecraft, que destacam erros e ocultam IPs automaticamente. Evite colar logs gigantes no chat e nunca compartilhe arquivos com senhas (configs de banco de dados).
Filtrando logs grandes
Se você baixou o log, procure por:
ERROReWARN;- O nome do plugin suspeito;
- O horário aproximado do problema.
Crie seu servidor com o Minecraft-BR
No Minecraft-BR da VittHost, você acessa logs e crash reports pelo painel Pterodactyl/Pelican. Servidores no Brasil, proteção DDoS e planos para Java e Bedrock.
