🚨 Corrija o erro "Por favor, reporte" do Jade em mods de Minecraft

Se o Jade exibir um aviso vermelho "Problema encontrado. Por favor, reporte ao Jade." em uma dica de ferramenta, significa que o Jade encontrou um erro ao exibir informações sobre um bloco, entidade, item ou integração com outro mod. O aviso é uma pista, não um diagnóstico: ele não prova que o Jade seja o único mod com defeito. Comece reproduzindo o mesmo problema, verificando o arquivo .bashrc da instância ativa logs/latest.loge certificando-se de que o Jade e os mods relacionados correspondam à versão exata do Minecraft e ao carregador de mods que você utiliza.

Jade é um HUD informativo para Minecraft Java Edition. A página do projeto indica que ele pode ser executado no lado do cliente, embora alguns recursos também exijam a presença do Jade no servidor. Essa distinção é importante caso o aviso apareça apenas no modo multijogador. Consulte a página do projeto e a lista de versões do Jade antes de modificar os arquivos.

O que significa o erro "Por favor, reporte" no Jade?

Jade coleta informações do objeto que você está visualizando e as exibe na tela. Um mod também pode fornecer informações adicionais para Jade por meio de uma integração. Se algo falhar enquanto a dica de ferramenta estiver sendo preparada, Jade poderá exibir um aviso de erro ou gerar uma saída de diagnóstico. A mensagem, por si só, não identifica qual componente gerou a exceção.

Separe um aviso na dica de ferramenta de uma falha completa do jogo. Se o jogo continuar rodando, capture o aviso e o objeto que o acionou. Se abrir um inventário, entrar em um mundo ou carregar um servidor causar a falha do jogo, preserve o relatório de falha, bem como o registro. O rastreador de problemas do Jade inclui um relatório onde o aviso na dica de ferramenta apareceu sobre itens descartados e ocorreu uma falha no inventário em uma configuração de servidor específica; esse exemplo mostra por que o gatilho exato e o ambiente são importantes, e não que todos os jogadores tenham a mesma causa. Veja o exemplo de problema do Jade .

Corrija o erro Jade passo a passo

1. Registre o gatilho e proteja seu mundo.

Anote o que você estava olhando quando a mensagem apareceu: o bloco, a criatura, o item dropado, a tela do inventário ou a máquina. Observe se isso acontece no modo para um jogador, no modo multijogador ou em ambos. Registre a versão do Minecraft, o loader (Fabric, Forge, NeoForge ou Quilt), a versão do Jade e qualquer add-on ou mod do Jade que forneça o bloco ou item afetado.

Antes de remover ou alterar mods, faça um backup do mundo e duplique o perfil do launcher ou a instância do pacote de mods. Não abra e salve um mundo que dependa de mods removidos; teste as alterações em uma cópia descartável. Se o erro ocorrer apenas em um servidor, compare um teste no modo single-player com esse servidor e pergunte ao administrador sobre as versões dos mods no servidor antes de alterar seu cliente.

2. Inspecione os arquivos de log corretos.

Reproduza o aviso uma vez, abra o diretório do jogo da instância ativa e inspecione o arquivo logs/latest.log. Um launcher de terceiros pode usar um diretório de jogo separado para cada perfil, portanto, não assuma que a .minecraftpasta padrão seja a utilizada. Procure próximo ao horário do erro por JadeErrorOutput, Exception, Caused bye o nome do mod ou integração que adiciona o conteúdo afetado. Alguns relatos mencionam um JadeErrorOutputarquivo ou pasta no diretório de logs; inclua-o se a sua instância o criou.

Se o Minecraft travou, verifique também crash-reportso relatório de erros correspondente. O guia de relatórios de erros do Fabric explica como os rastreamentos de pilha e as listas de mods podem ajudar a identificar a causa, alertando que um mod mencionado no rastreamento não é automaticamente o único culpado. Leia o guia de relatórios de erros do Fabric . Mantenha as linhas de exceção e "Caused by" (Causado por); uma única linha de erro final geralmente não fornece o contexto necessário.

3. Combine Jade e os acessórios com a sua configuração exata.

Baixe o Jade para a versão exata do Minecraft e o carregador usado pela instância. Um arquivo para Fabric não é intercambiável com uma versão para Forge ou NeoForge, e uma versão para uma versão diferente do Minecraft pode falhar mesmo que o nome do arquivo seja semelhante. Use os filtros de versão na página do projeto Jade e verifique a página de lançamento de cada complemento que participa da dica de ferramenta.

Os complementos do Jade são integrações opcionais, não uma dependência universal que toda instalação precisa adicionar. Instale ou atualize um somente quando desejar as integrações suportadas e a versão for compatível com sua configuração. Atualize através do próprio inicializador ou das instruções do pacote de mods, quando possível; substituir arquivos individuais em um pacote selecionado pode criar uma nova incompatibilidade de versão. Remova arquivos JAR duplicados da modspasta ativa após confirmar que a substituição está correta. Não adicione Cloth Config, Architectury ou um argumento Java apenas porque um guia não relacionado os lista — use uma dependência somente quando a página de lançamento do mod selecionado exigir.

Analise as versões disponíveis do Jade e compare a versão do jogo e o carregador exibidos no arquivo com o perfil que você realmente executa.

4. Isole o mod que fornece a dica de ferramenta com defeito.

Use sua instância copiada ou um mundo de teste descartável. Mantenha o carregador, o Jade e apenas as dependências listadas para esses arquivos e teste se o aviso retorna. Se ele desaparecer, adicione os mods restantes de volta em pequenos lotes. Quando o problema retornar, teste o último lote um mod por vez. Comece com o mod que adiciona ou altera o objeto que disparou o aviso, além de sua integração com o Jade, se houver.

Altere um item por vez, em cada teste, e repita a mesma ação. Se a mensagem estiver relacionada a um bloco ou item específico, remover o conteúdo dele pode torná-lo indisponível. Portanto, use um mundo de teste e não sobrescreva seu mundo original. Quando o problema ocorrer apenas no servidor, compare os logs do cliente e do servidor, se disponíveis. O Jade documenta que alguns recursos exibidos precisam de suporte do servidor, então peça ao administrador do servidor para verificar a configuração relevante do servidor em vez de instalar todos os mods em ambos os lados sem saber o que está acontecendo.

Quando e onde reportar o erro

Informe ao Jade se o problema persistir mesmo com uma configuração mínima e compatível ou se o rastreamento de pilha apontar para o próprio Jade. Se a exceção identificar o provedor de dicas de ferramentas ou a integração de outro mod, verifique também o rastreador de problemas desse mod; o responsável pela manutenção pode ser aquele que forneceu as informações sobre a falha. O próprio rastreador de problemas do Jade solicita o log mais recente nos relatórios de bugs. Abra o rastreador de problemas do Jade .

• Inclui o Minecraft, o carregador, o Jade e as versões relevantes dos complementos.
• Liste os passos exatos e o objeto que reproduzem o aviso.
• Informe se o problema ocorre no modo para um jogador, no modo multijogador ou em ambos.
• Anexe latest.logqualquer JadeErrorOutputsaída e um relatório de falha, caso o jogo tenha travado.
• Indique se você reproduziu o problema utilizando apenas as modificações relevantes.

Antes de publicar registros publicamente, revise-os em busca de endereços de servidores privados, detalhes de contas ou outras informações que você não deseja compartilhar. Mantenha o contexto de exceção e a lista de mods intactos ao remover detalhes privados irrelevantes.

Verificações rápidas e prevenção

Faça um backup antes de atualizar um pacote de mods grande, evite misturar versões do carregador e salve as versões funcionais quando o pacote estiver estável. Esses hábitos facilitam a identificação de qual atualização alterou o comportamento e fornecem ao mantenedor informações suficientes para reproduzir um erro de dica de ferramenta do Jade no Minecraft .