MC Toolkit

Guias / Solução de problemas

Um addon de Bedrock é um zip, e o manifest é o motivo da falha

A maioria das importações de .mcaddon rejeitadas é um zip válido com uma linha errada no cabeçalho, e a mensagem de erro nunca diz qual campo causou o problema.

Um .mcaddon é um arquivo zip com uma extensão diferente, e o jogo o rejeita por motivos que não têm nada a ver com o zip. O culpado de sempre é o manifest.json — um arquivo pequeno com um UUID de cabeçalho e um UUID de módulo que precisam ser diferentes, além de um format_version que não é a versão do jogo para a qual você está mirando.

Dois UUIDs, nunca o mesmo

Um manifest carrega um header e um array modules. Cada um precisa do seu próprio uuid, e reutilizar o mesmo nos dois é a rejeição mais comum de todas:

{
  "format_version": 2,
  "header": {
    "name": "My Pack",
    "description": "Example",
    "uuid": "aaaaaaaa-0000-0000-0000-000000000000",
    "version": [1, 0, 0],
    "min_engine_version": [1, 21, 0]
  },
  "modules": [
    {
      "type": "data",
      "uuid": "bbbbbbbb-0000-0000-0000-000000000001",
      "version": [1, 0, 0]
    }
  ]
}

UUIDs são valores de 128 bits escritos como 32 dígitos hexadecimais em cinco grupos separados por hífen. Qualquer gerador serve; duplicar, não. version e min_engine_version são arrays de três inteiros, não strings — "1.0.0" é recusado.

Java não tem manifest nenhum

É essa a diferença que derruba quem transita entre as edições. Um pacote de recursos de Java traz um pack.mcmeta declarando os formatos que ele suporta (min_format e max_format nas versões atuais). O Bedrock traz manifest.json com UUIDs e uma lista de módulos. Nenhum dos dois arquivos é lido pela outra edição, e não dá para portar um pacote apenas renomeando o arquivo.

Confira antes de importar

Descompacte o arquivo e olhe o nível superior. Um pacote aninhado uma pasta abaixo — MyPack/manifest.json em vez de manifest.json — é importado como nada, sem erro nenhum. O manifest precisa ficar na raiz de cada pacote, ao lado das pastas que ele descreve.

Modelos de bloco são um formato à parte

Um JSON de modelo de bloco de Java não é um arquivo de geometria de Bedrock, e os dois não são intercambiáveis. Um modelo de Java geralmente é só um parent mais um mapa textures — uma lista elements de cuboides só é necessária para uma forma personalizada — enquanto o Bedrock descreve formas no seu próprio formato minecraft:geometry. Os dois medem 16 unidades por bloco, e é por isso que um modelo pode parecer certo em uma edição e ser importado como nada na outra.

Nomes de registro não são intercambiáveis

Bedrock e Java discordam nos identificadores do mesmo conteúdo. Um pacote que referencia um nome de Java para um encantamento, efeito ou bioma vai carregar e depois não fazer nada, silenciosamente, porque o nome não corresponde a entrada alguma. Os próprios registros têm tamanhos diferentes entre as edições, então não dá para presumir que um pacote feito com base na lista de uma edição esteja completo na outra.

Valide o manifest, confira a estrutura do arquivo e gere um modelo de bloco no Bedrock & Pack Tools.

Ferramentas de Bedrock e pacotes →

Mais guias

Ver todos →