Falhas do Jenny Mod: diagnóstico e correções

Comece pelo primeiro erro útil

Anote exatamente quando a falha acontece: antes de abrir o launcher, durante o carregamento do Forge, no menu principal, ao abrir um mundo ou quando uma personagem aparece. Essas etapas apontam para causas diferentes, então evite alterar várias coisas ao mesmo tempo.

Um código de saída como 1 apenas confirma que o processo parou. Abra o registro e procure, acima das linhas finais, a primeira mensagem clara sobre dependência ausente, versão incompatível, mod duplicado, Java heap space ou um ID de mod específico.

• Falha antes da tela Mods: confira o perfil selecionado, Java, a compilação do Forge e as dependências.
• Falha ao abrir apenas um mundo: teste um mundo novo antes de alterar o save original.
• Falha quando uma entidade ou efeito aparece: teste sem shaders, pacotes de recursos e mods de renderização não relacionados.
• Todos os perfis Forge falham: execute um perfil Forge limpo sem mods para separar um problema do carregador de um conflito.

Confirme a edição, a versão do Minecraft e o carregador

Um .jar do Forge para Java Edition não funciona como .mcpack ou .mcaddon do Bedrock, e trocar a extensão não faz a conversão. Este guia trata principalmente da rota Forge no Java Edition; problemas de importação e ativação no Bedrock exigem outro diagnóstico.

Confira a versão exata do Minecraft mostrada no perfil, a versão do Forge associada a ele e os dados de versão incluídos ou fornecidos com o arquivo do mod. Não escolha a versão mais nova do Forge apenas pelo nome. Cada compilação pertence a uma linha específica do Minecraft, e um mod também pode declarar intervalos para carregador, jogo ou dependências.

• Inicie o perfil Forge correto, não o perfil padrão do Minecraft.
• Mantenha o mod como .jar intacto na pasta mods real desse perfil.
• Remova do perfil de teste cópias duplicadas e arquivos criados para outra versão do Minecraft.
• Se não for possível identificar a versão-alvo do arquivo, não tente adivinhar com inicializações repetidas.

Encontre o relatório da falha e o latest.log

Abra o diretório do jogo usado pelo perfil que falha. O arquivo mais recente em crash-reports registra a falha quando o Minecraft conseguiu criá-lo. A pasta logs normalmente contém latest.log, e o suporte do Forge também pode pedir debug.log porque ele traz mais detalhes do carregador. Uma inicialização interrompida nem sempre produz relatório, então latest.log ou debug.log pode ser o melhor registro.

Leia o contexto completo, não apenas a última linha ou a mensagem do launcher. Oculte seu nome de usuário e caminhos privados ao compartilhar um registro, e nunca publique tokens ou credenciais. O suporte do Forge solicita o registro atual completo e o relatório mais recente quando ele existe.

• Perfil padrão no Windows: abra o diretório de jogo da instalação selecionada em vez de supor que todos usam %appdata%\.minecraft.
• Perfil do CurseForge: abra a pasta do perfil e confira logs e crash-reports.
• Procure a primeira falha explícita e anote o ID do mod, a versão exigida e o nome da exceção.
• Salve o registro original antes que outra inicialização substitua latest.log.

Teste dependências ausentes e conflitos entre mods

Se o registro citar um mod ausente ou um intervalo de versão não aceito, resolva exatamente esse requisito a partir de uma fonte rastreável. Não instale uma biblioteca aleatória só porque outro guia a usa; as dependências podem variar entre compilações.

Para testar um conflito, crie outro perfil com as mesmas versões de Minecraft e Forge. Inicie o Forge sem mods e depois adicione Jenny Mod junto apenas das dependências confirmadas para esse arquivo. Se funcionar, restaure os outros mods em pequenos grupos até a falha voltar. O último grupo reduz a busca sem arriscar o perfil funcional.

• Mantenha uma lista de cada arquivo removido e sua versão.
• Altere um grupo por vez e inicie o jogo após cada mudança.
• Não teste um possível conflito em um mundo importante.
• Trate um mod citado no fim do stack trace como pista, não como prova automática; confira o primeiro erro causal.

Confira Java e memória apenas quando houver evidência

Use a geração do Java exigida pela versão de Minecraft e Forge do perfil. A documentação do Forge relaciona Minecraft 1.12 a 1.16 ao JDK 8 para desenvolvimento, enquanto linhas mais novas usam gerações posteriores. Trocar Java sem conferir pode corrigir um perfil e quebrar outro; confirme primeiro o executável e a versão ativos.

Se o registro contiver java.lang.OutOfMemoryError ou Java heap space, feche programas pesados, remova shaders ou pacotes de recursos opcionais e reveja a memória do perfil. A Oracle explica que Java heap space pode indicar heap insuficiente, mas também pode ter outras causas. Não entregue quase toda a memória do sistema ao Minecraft nem aumente a memória quando o registro mostrar erro de versão ou dependência.

• Confirme se o launcher usa o ambiente Java integrado ou um caminho personalizado.
• Remova argumentos JVM personalizados e antigos antes de testar um perfil limpo.
• Anote o valor atual de memória antes de alterá-lo para poder reverter o teste.
• Se o erro mencionar memória nativa, driver gráfico ou violação de acesso, aumentar o heap pode não resolver.

Associe a correção à etapa da falha

Use a etapa e a primeira mensagem causal em conjunto. Uma rejeição de versão durante o carregamento do Forge exige corrigir versões; uma falha que ocorre só em um mundo pede um teste seguro desse mundo; um erro ativado por efeito visual exige um teste gráfico mínimo. Isso é mais confiável do que aplicar todas as correções populares em sequência.

• Forge rejeita o arquivo: combine Minecraft, Forge, a compilação do mod e as dependências declaradas.
• O menu funciona, mas um mundo fecha: faça backup, teste um mundo novo e remova conteúdo opcional do perfil de teste.
• A falha começou após adicionar outro mod: restaure o último conjunto funcional e recoloque os arquivos em pequenos grupos.
• Tela preta ou falha de renderização: teste sem shaders e pacotes de recursos e verifique o driver no site do fabricante.
• OutOfMemoryError: reduza a carga opcional e ajuste a memória com cuidado após confirmar a exceção.
• Não há relatório da falha: use latest.log ou debug.log da sessão interrompida.

Repare o perfil sem apagar seus mundos

Copie as pastas saves e do perfil antes de qualquer reparo. Um perfil limpo é mais seguro do que apagar a instalação original porque mantém a configuração com problema para comparação e preserva os mundos para recuperação.

Crie um perfil para a versão planejada do Minecraft, execute-o uma vez, instale a linha correspondente do Forge e confirme que ele chega ao menu sem mods. Adicione somente o arquivo identificado e as dependências verificadas. Abra primeiro um mundo descartável. Se funcionar, mova uma cópia do mundo afetado para o perfil de teste e verifique separadamente.

• Não apague saves, capturas ou opções ao diagnosticar uma falha do carregador.
• Não sobrescreva a única cópia de um mundo com um perfil de teste.
• Mantenha a última lista funcional de mods junto do backup.
• Use Repair Installation do CurseForge apenas para um problema do aplicativo ou da instalação; ele não resolve sozinho uma combinação incompatível de mods.

Prepare um pedido de suporte útil

Se a falha continuar, registre edição e versão do Minecraft, versão do Forge, versão do Java, launcher, nome exato do arquivo, etapa da falha e alteração mais recente. Inclua latest.log ou debug.log completo e o relatório mais novo, caso tenha sido criado. Um registro completo ajuda mais do que uma captura de Exit Code 1.

Descreva o resultado do teste com Forge limpo e do teste com o mínimo de mods. Isso mostra se o problema acompanha o carregador, este arquivo, uma dependência, outro mod ou um mundo específico, evitando a repetição de etapas.

• Remova nomes de usuário, tokens e caminhos privados antes de compartilhar.
• Compartilhe registros em texto por um serviço de colagem confiável, não por capturas.
• Não retire linhas de erro por parecerem não relacionadas.
• Informe cada mudança feita e se ela alterou o resultado.

Perguntas frequentes