Modpack não inicia ou congela na inicialização

Quando um servidor modificado trava no meio da inicialização — o console fica em silêncio e nunca chega a "Done" — ou falha ao iniciar, é quase sempre um conflito de mods ou um mod quebrado/desatualizado, não um problema com o próprio servidor. Veja como encontrar o culpado e fazer o servidor funcionar novamente.

Congelado vs. travado — saiba a diferença

• Travado: o console imprime um erro e o processo para. Você verá um stack trace e, muitas vezes, um relatório de falha em crash-reports/.
• Congelado (preso): o servidor parece "ativo", mas nunca termina de carregar e ninguém consegue entrar. O log simplesmente para no meio da inicialização. Isso geralmente significa que dois mods estão em deadlock durante a inicialização.

Ambos são diagnosticados da mesma forma: lendo o log e isolando o mod ofensivo.

1. Leia o log, de cima para baixo

Abra o Console, reinicie e leia do início. Para Forge/NeoForge, o arquivo mais útil é logs/fml-server-latest.log (abra-o no File Manager). Procure pela primeira ocorrência de:

ERROR   FATAL   Caused by:   LoadingFailedException   NoClassDefFound

O primeiro mod que apresenta erro é geralmente a causa raiz. Mods listados posteriormente como "errored because dependency X errored" são apenas ruído secundário — ignore-os e foque no primeiro.

2. Fique atento a mods de desempenho em conflito

Mods de desempenho (Redirector, Canary, ModernFix, Rubidium, Embeddium e similares) modificam profundamente os internos do jogo, e versões desatualizadas podem causar deadlock na inicialização — o sintoma clássico de "servidor parece ativo, mas está congelado no meio da inicialização". Se o seu pacote congelou após uma atualização, ou você está usando versões de mods com alguns meses, estes são os principais suspeitos.

3. Desative o mod suspeito

Você não precisa excluir nada — apenas remova-o do caminho de carregamento:

1. No File Manager, abra a pasta mods/.
2. Renomeie o jar suspeito de algo.jar para algo.jar.disabled. (A extensão .disabled impede que ele seja carregado e facilita a reativação posterior.)
3. Reinicie e observe o console.

Se agora ele inicializar além do ponto de congelamento/travamento, você o encontrou. Caso contrário, reative-o e tente o próximo suspeito. Altere um mod por vez para saber qual fez a diferença.

4. Proteja seu mundo antes de um novo começo

Se um mundo foi corrompido (ou você quer testar uma inicialização limpa), não o exclua — arquive-o:

1. No File Manager, renomeie world para world-broken-<data>.old.
2. Reinicie. O servidor gera um mundo novo e inicializa limpo.
3. Seu mundo antigo ainda estará lá se você quiser recuperá-lo mais tarde.

Atenção — a geração de mundo é lenta com pacotes grandes. Após uma nova inicialização, um modpack pesado pode levar 5–15 minutos na geração de chunks antes de chegar a "Done" — mods como MineColonies ou Alex's Mobs escaneando biomas na inicialização é normal. Se a CPU estiver trabalhando de verdade (não travada em 0%), dê tempo antes de assumir que está preso.

5. Corrija adequadamente: atualize os mods

Desativar um mod de desempenho custa alguns FPS, mas não quebra a jogabilidade, então é uma solução temporária aceitável. A correção real geralmente é atualizar os mods conflitantes — a maioria teve lançamentos de correção de bugs que resolvem esses conflitos. Baixe as versões mais recentes para sua versão do Minecraft/loader, coloque-as em mods/ (substituindo os jars antigos) e reative tudo o que você desativou.

Padrões comuns

• Congela logo após um mod específico registrar: esse mod (ou o próximo a inicializar) está em deadlock — desative-o.
• Missing or unsupported mandatory dependencies: um mod de biblioteca necessário está faltando ou é a versão errada — adicione/corrija-o.
• Incompatible mod set! / versão incompatível: um mod é construído para uma versão diferente do Minecraft ou do loader do seu pacote.
• Trava apenas quando um jogador entra, não na inicialização: isso geralmente é uma incompatibilidade de lista de mods cliente/servidor — veja Instalando um modpack.

Ainda preso?

Abra um ticket de suporte com o primeiro erro de fml-server-latest.log (ou um link para o relatório de falha). Podemos analisar o conjunto de mods diretamente no nó, desativar mods conflitantes para você e adicionar versões atualizadas para que você possa vê-lo funcionando.