Resolvendo crashes em servidores com mods
Servidores modados crasham — faz parte. A boa notícia é que, com método, quase todo crash tem solução. Siga este roteiro.
1. Encontre o crash report
crash-reports/— um arquivo por crash, com data e hora no nome;logs/latest.log— o que aconteceu antes do crash;logs/debug.log(em alguns loaders) — detalhes extras.
2. Leia as partes certas
No crash report, procure:
Description:— resumo (ex.: "Exception ticking entity", "Mod loading has failed");- Stack trace — linhas
at ...com nomes de pacotes que indicam o mod (ex.:com.simibubi.create); -- Head --e-- Block entity being ticked --/-- Entity being ticked --— mostram o que e onde (coordenadas!).
3. Causas mais comuns
Mod de cliente no servidor
Mods de renderização, shaders, minimapas, menus e sons não devem estar no servidor. Sintomas: erros mencionando classes de cliente, como net/minecraft/client/..., ou mensagens de "invalid dist".
Solução: use o server pack oficial ou remova os mods de cliente.
Dependência ausente
Mensagens como "Mod X requires Y" ou "Missing mods".
Solução: instale a dependência na versão indicada (ex.: Fabric API, Architectury, Cloth Config, GeckoLib).
Versão errada
Mod feito para outra versão do Minecraft ou do loader.
Solução: baixe a versão correta de cada mod.
Java incompatível
UnsupportedClassVersionError.
Solução: ajuste a versão do Java na inicialização.
Falta de memória
OutOfMemoryError.
Solução: mais RAM ou menos mods.
Conflito entre mods
Erros de Mixin ("Mixin apply failed") ou crashes que só acontecem com dois mods juntos.
Solução: atualize os dois; se persistir, remova um deles ou procure relatos nas páginas de issues dos mods.
Entidade ou bloco corrompido
"Exception ticking entity/block entity" com coordenadas.
Solução: algumas versões e loaders têm opções para remover entidades/blocos com erro; também é possível usar ferramentas de edição de mundo para apagar o item problemático nas coordenadas indicadas — sempre com backup.
4. Método da divisão (quando nada é óbvio)
- Faça backup;
- Remova metade dos mods (cuidado com dependências) e teste;
- Se o crash sumir, o culpado está na metade removida; se não, na outra;
- Repita até encontrar o mod.
Teste em uma cópia do servidor, não no mundo principal.
5. Peça ajuda do jeito certo
- Envie o crash report por um serviço como mclo.gs;
- Informe versão do Minecraft, loader e modpack;
- Diga o que mudou antes do crash (mod novo, atualização, construção específica).
Prevenção
- Não atualize mods individualmente em um modpack sem testar;
- Mantenha backups automáticos;
- Use o server pack oficial;
- Anote as mudanças que você faz.
Crie seu servidor com o Minecraft-BR
No Minecraft-BR da VittHost, você acessa crash reports, logs e backups pelo painel Pterodactyl/Pelican. Servidores no Brasil, proteção DDoS e planos para Java e Bedrock.
