Mods do Minecraft Java não iniciam? Confira versões e dependências

Se o jogo com mods não inicia, faça backup da instância e do mundo primeiro. Depois confira versão do Minecraft, carregador, versão do mod e dependências obrigatórias. Dois arquivos .jar não são necessariamente compatíveis. Este guia é para Java Edition; complementos Bedrock usam outro sistema.

Preserve o estado

Feche o jogo e copie as pastas existentes mods, config, saves e logs da instância afetada. Não apague toda a pasta do jogo nem teste a remoção de mods no seu único mundo principal.

Na pasta da instância afetada, examine logs/latest.log e, se houver, o relatório correspondente em crash-reports. Iniciadores de terceiros podem ter uma pasta para cada instância. A ausência de relatório não significa ausência de erro de carregamento.

Confira as combinações

• Versão do Minecraft: siga a faixa indicada pelo autor, não um nome de arquivo parecido.
• Carregador: use o explicitamente suportado pelo mod. Fabric, Forge e NeoForge não são automaticamente intercambiáveis.
• Dependências: instale bibliotecas obrigatórias e versões compatíveis indicadas pelo autor; cada mod tem suas exigências.
• Duplicatas e ambiente: após o backup, retire versões duplicadas. Se configurou um caminho Java personalizado, confira os requisitos do jogo e do carregador; a versão Java mais nova não resolve tudo.

Em modpacks, siga a lista do autor; não atualize todos os mods de uma vez no início da investigação.

Uma instalação nova no launcher não isola automaticamente a pasta mods. No Minecraft Launcher, abra Java Edition → Installations, crie ou edite a instalação de teste e defina Game Directory como uma pasta nova separada antes de iniciar. Selecione o perfil do carregador e confirme a pasta antes de copiar mods de teste. A pasta separada tem saves e config próprios; não aponte para o único mundo original.

Leia o log e isole

Procure mensagens de dependência ausente, versão incompatível ou falha de carregamento; anote IDs e versões exigidas. Um mod citado é uma pista, não prova de que seja o único culpado. Apenas um código de saída, inclusive o 1, não prova falta de memória. Antes de compartilhar logs, revise dados de conta, endereços de servidor e caminhos pessoais.

Crie uma instância de teste separada com a mesma versão e carregador e confirme que inicia num mundo vazio. Adicione o mod alvo com suas dependências e depois os outros em grupos, mantendo as dependências completas. Registre cada mudança. Para pedir ajuda ao autor, envie versões, lista de mods, passos de reprodução e o log completo relevante.

A documentação Fabric citada é um exemplo para esse carregador; consulte a documentação dos demais. Não instalamos os mods nem reproduzimos sua falha.

Sources

Fabric: Installing Mods · Fabric: Crash Reports · Fabric: Uploading Logs Forge Forums: Support FAQ