Como resolver "mod incompatível" ou crash no carregamento de mods

1. Onde encontrar as informações do crash

Quando o servidor trava ao iniciar, o Minecraft costuma gerar dois tipos de arquivo úteis:

• logs/latest.log — registro completo do que aconteceu até o travamento.
• crash-reports/crash-*.txt — relatório detalhado do erro, geralmente mais fácil de ler.

Acesse esses arquivos pela aba Arquivos do painel.

2. Verificando a versão do Forge/Fabric/NeoForge

A causa mais comum de crash é incompatibilidade de versão:

• Confira se o mod foi feito para a mesma versão do Minecraft instalada no servidor (ex.: mod para 1.20.1 em servidor 1.21 não funciona).
• Confira se o mod é para o loader correto — um mod de Fabric não funciona em servidor Forge, e vice-versa.

3. Dependências faltando

Muitos mods dependem de bibliotecas extras para funcionar. As mais comuns são:

• Fabric API (obrigatória para a maioria dos mods de Fabric).
• Forge Config API Port, Architectury API, Cloth Config (usadas por vários mods multiplataforma).

No crash-report, procure por mensagens como:

  Mod X requires Y, which is missing

Isso indica exatamente qual dependência precisa ser instalada na pasta mods.

4. Mods client-side rodando no servidor

Alguns mods são feitos apenas para o cliente (ex.: mods de interface, shaders, minimapas) e não devem ser colocados no servidor — isso costuma causar crash imediato ao iniciar.

5. Encontrando qual mod está causando o problema

No crash-report, procure a seção "Affected Mods" ou o stacktrace, que geralmente mostra o nome do mod culpado logo no início do erro.

Se não estiver claro, use o método de bisecção:

1. Remova metade dos mods da pasta mods (mova para outra pasta, não delete).
2. Reinicie o servidor.
3. Se o erro sumir, o mod problemático está no grupo removido — repita o processo dividindo esse grupo ao meio.
4. Se o erro continuar, o problema está no grupo que ficou — repita o processo.

6. Conflito entre mods

Dois mods podem entrar em conflito quando alteram a mesma coisa do jogo (ex.: dois mods que modificam geração de mundo). Nesse caso:

• Verifique se existe uma versão de compatibilidade entre eles (muitos mods populares lançam "compat patches").
• Consulte a página do mod no CurseForge/Modrinth por avisos de incompatibilidade conhecida.

7. Soluções mais comuns

• Atualizar o mod para a versão mais recente compatível com o servidor.
• Instalar a dependência que está faltando.
• Remover mods client-side da pasta do servidor.
• Reinstalar o Forge/Fabric caso os arquivos do loader estejam corrompidos.