Corrigindo erros de carregamento de complementos no Minecraft Bedrock 1.21: Guia passo a passo seguro

Se um complemento do Minecraft Bedrock não carregar , primeiro faça uma cópia do mundo afetado e verifique se o pacote foi importado, está ativado nesse mundo e é compatível com a sua versão exata do jogo. Se o problema persistir, desative os pacotes na cópia e ative-os um de cada vez. Um problema de carregamento de mods no Bedrock pode ser causado por uma importação corrompida, um erro no manifesto ou nas dependências, uma incompatibilidade de versões ou dois pacotes sobrescrevendo o mesmo conteúdo.

A versão Bedrock chama esses arquivos de complementos (add-ons) , geralmente compostos por pacotes de recursos, pacotes de comportamento ou ambos. Mods da Edição Java não são intercambiáveis ​​com complementos da versão Bedrock. A expressão "erro ao carregar mod no Minecraft" descreve vários sintomas, em vez de um código de erro oficial, portanto, a solução correta depende de quando o problema aparece.

Identifique onde o complemento falha.

• A importação para ou relata falha: suspeita-se de um download incompleto, tipo de arquivo incorreto ou estrutura de pacote que o Minecraft não consegue ler.
• O pacote é importado, mas está faltando no editor de mundo: verifique o manifesto, a extensão do arquivo e se é um pacote de comportamento ou de recursos.
• O pacote aparece com um aviso ou não ativa: verifique o aviso para identificar uma dependência ausente ou outro problema no manifesto.
• O mundo abre, mas o conteúdo está ausente ou parece inalterado: verifique se o pacote correto está ativo e se outro pacote tem prioridade sobre ele.

O guia para criadores do Minecraft identifica manifestos malformados, UUIDs duplicados ou incompatíveis, dependências ausentes, extensões de arquivo e sobreposição de pacotes como áreas comuns de problemas. Também explica que os pacotes de comportamento e de recursos são selecionados em suas respectivas abas ao editar um mundo. Consulte o guia oficial de solução de problemas de pacotes de comportamento .

Antes de solucionar problemas, proteja o mundo.

Não teste correções na única cópia de um mundo que seja importante para você. Use a opção de cópia ou backup do Minecraft quando disponível e dê um nome claro à cópia de teste. Anote a versão do Bedrock, a fonte do complemento e quais pacotes estão ativos. Evite excluir as pastas do mundo ou dos pacotes como primeiro passo.

As instruções de armazenamento do Windows podem mudar entre as versões do Minecraft. Em particular, o antigo caminho da pasta Microsoft Store/UWP impresso em muitos guias antigos não deve ser considerado válido para todas as instalações: a Microsoft documenta uma migração de armazenamento do Windows a partir do Minecraft 1.21.120. Use as instruções de caminho da sua versão instalada em vez de colar um caminho desatualizado. Leia as orientações atuais da Microsoft sobre pastas de projeto do Windows .

Corrigir erros de carregamento de complementos do Minecraft Bedrock

1. Confirme a edição e a versão do jogo.

Verifique se o download é para Minecraft: Bedrock Edition , e não para Java Edition, e se é compatível com sua plataforma e versão do jogo. A versão "1.21" abrange várias versões, e as versões de pré-visualização podem se comportar de maneira diferente da versão regular. Siga o intervalo de compatibilidade declarado pelo criador do pacote. O manifesto min_engine_versionindica um requisito mínimo; ele não garante que todos os recursos do pacote funcionarão em todas as versões posteriores. A Microsoft explica o campo em sua referência de manifesto .

Atualize o Minecraft pela loja oficial ou pelo aplicativo inicializador do seu dispositivo se o complemento exigir uma versão compatível mais recente. Se o problema começou imediatamente após uma atualização, verifique as notas de lançamento do criador para encontrar uma revisão compatível do pacote antes de editar os arquivos por conta própria.

2. Reimporte uma cópia limpa do pacote.

Se a importação falhar, baixe o pacote novamente do criador ou use a versão oficial da Marketplace que você possui. Um arquivo .mcpack.package é um pacote de recursos ou comportamentos; um arquivo .package .mcaddonpode conter vários arquivos adicionais. Ao abrir um arquivo .package .mcpackcom o Minecraft, o jogo deve informar se a importação foi bem-sucedida. Se você recebeu um arquivo ZIP, não o renomeie simplesmente e assuma que ele é válido: siga as instruções de instalação do criador e confirme se o arquivo contém a estrutura de pacote esperada.

Para acessar o conteúdo do Marketplace, inicie o Minecraft Bedrock com a conta proprietária do item e verifique o Marketplace ou seu conteúdo adquirido dentro do jogo. O guia oficial de instalação de complementos descreve a notificação de importação e onde os pacotes ficam disponíveis após a importação.

3. Ative o pacote no mundo afetado.

A instalação de um pacote não ativa automaticamente todos os pacotes em todos os mundos. No menu Jogar, abra a tela de edição/configurações do mundo e encontre Complementos . Ative a entrada correta em Pacotes de Comportamento , Pacotes de Recursos ou ambos, dependendo do que o complemento contém. Em seguida, teste o mundo copiado. As instruções de ativação de complementos do Minecraft explicam o processo dentro do jogo.

Se você não tiver certeza se o problema está no mundo existente ou em outro pacote de expansão, crie um novo mundo temporário e ative apenas o pacote suspeito nele. Se funcionar no novo mundo, concentre-se nos pacotes ou configurações ativos do mundo original, em vez de reinstalar o jogo.

4. Isolar complementos conflitantes

No mundo copiado, desative os complementos relevantes e teste novamente. Reative um pacote de cada vez, reabrindo o mundo após cada alteração, até que o problema retorne. Isso identifica o pacote ou a combinação que causa a falha. O Suporte do Minecraft recomenda fazer backup do mundo e desativar os complementos individualmente ao diagnosticar problemas no jogo; consulte as etapas de solução de problemas de complementos .

Se cada pacote funcionar individualmente, mas não em conjunto, verifique se há conteúdo e dependências sobrepostas. Dois pacotes que alteram a mesma entidade, item, textura ou outro recurso podem sobrescrever um ao outro. O Minecraft usa o empilhamento de pacotes, portanto, a ordem pode afetar qual alteração aparece. Na cópia de teste, reordene o pacote relevante, se o jogo oferecer essa opção, e teste novamente. Não remova nenhuma dependência que o pacote exija.

5. Verifique as dependências do pacote de comportamento e do pacote de recursos.

Alguns complementos contêm um pacote de comportamento e um pacote de recursos separado. Um pacote de comportamento pode declarar uma dependência de um pacote de recursos referenciando o UUID e a versão do cabeçalho do pacote de recursos em seu manifesto. Se esses valores não corresponderem, o comportamento poderá ser carregado sem suas texturas ou o pacote poderá exibir um aviso. O tutorial oficial do pacote de comportamento mostra como funciona o vínculo de dependência.

Leia a mensagem detalhada exibida para o pacote nas configurações de Complementos do mundo. Um aviso de dependência ausente é mais útil do que importar repetidamente os mesmos arquivos. Se este pacote for de outra pessoa, baixe uma versão corrigida ou entre em contato com o criador em vez de alterar os UUIDs aleatoriamente.

6. Se você criou o pacote, valide o manifesto dele.

Edite um arquivo de manifesto somente se você for o proprietário do pacote ou souber exatamente a função de cada campo. Para pacotes de recursos e comportamentos estáveis ​​atuais, as diretrizes da plataforma da Microsoft especificam ` format_version 2<nome_do_pacote>`. Este é o formato do manifesto, não a versão do jogo Minecraft: não o substitua por um valor como ` <nome_do_pacote> `. 1.21.70O requisito do jogo pertence a `<nome_do_pacote>` , geralmente representado como uma versão de três partes, como `<nome_do_pacote>`. Use uma versão mínima compatível apropriada para os arquivos do seu pacote, em vez de copiar um número cegamente. Consulte as diretrizes de versão da plataforma da Microsoft .header.min_engine_version[1, 21, 0]

• Confirme se o arquivo tem o nome correto manifest.json, se é um JSON válido e se está localizado no nível superior do pacote.
• Atribua um UUID válido ao cabeçalho do pacote e a cada módulo. O UUID do módulo deve ser diferente do UUID do cabeçalho do pacote.
• Para uma dependência declarada, certifique-se de que o UUID e a versão referenciados correspondam exatamente ao manifesto do pacote necessário.
• Mantenha a consistência no tipo de módulo e nos arquivos: pacotes de comportamento usam módulos de dados; pacotes de recursos usam módulos de recursos.

A documentação de referência do manifesto da Microsoft lista esses campos. Um validador JSON pode detectar vírgulas, chaves ou aspas ausentes, mas não pode confirmar se o conteúdo de um pacote é compatível ou se suas dependências estão corretas.

Notas da plataforma

• Windows: evite usar caminhos de pastas antigos copiados de guias de pré-migração. Use o local atual da sua instalação e faça um backup antes de mover os arquivos manualmente.
• Android e iOS: o acesso aos arquivos depende do dispositivo e da versão do aplicativo. Não limpe os dados do aplicativo Minecraft nem desinstale o jogo como primeira solução; essas ações podem colocar seus mundos locais em risco se não houver um backup.
• Console: utilize o Marketplace e as configurações do mundo dentro do jogo para acessar o conteúdo compatível. As instruções do gerenciador de arquivos para desktop não se aplicam ao armazenamento do console.

Quando reinstalar — e como evitar que isso se repita

Reinstalar o Minecraft é o último recurso, não a primeira solução para problemas com complementos. Antes de desinstalar, certifique-se de que todos os seus mundos importantes estejam salvos em um backup usando um método compatível com seu dispositivo. Se apenas um pacote estiver corrompido, remova ou substitua esse pacote em vez de excluir todos os dados do jogo. Para itens da Loja, verifique a conta proprietária e baixe o conteúdo novamente pelo Minecraft.

Para instalações futuras, mantenha um backup limpo antes de adicionar pacotes a um mundo já existente, teste complementos desconhecidos em uma cópia ou em um novo mundo, instale um pacote por vez e salve as notas de compatibilidade do criador. Isso facilita a identificação de erros de carregamento de complementos do Minecraft Bedrock sem correr o risco de perder um jogo salvo há muito tempo.

Perguntas frequentes

Posso usar mods da Java Edition no Bedrock?

Não. Os mods para Java são feitos para uma edição diferente. O Bedrock usa complementos criados a partir de pacotes de recursos e/ou pacotes de comportamento, então baixe uma versão do conteúdo compatível com o Bedrock.

Alterar essa min_engine_versionconfiguração corrigirá um complemento incompatível?

Não por si só. Esse campo indica a versão mínima do jogo exigida pelo pacote; alterá-lo não converte arquivos incompatíveis, não atualiza scripts nem corrige dependências. Use uma versão compatível com a sua versão do jogo ou atualize e valide seu próprio pacote usando a documentação da Microsoft para criadores.