Guias / Solução de problemas

pack.mcmeta: números de pack_format e o aviso de "incompatível"

Um número errado faz o Minecraft desabilitar seu pacote. Aqui está o mapeamento de formato para versão, o intervalo supported_formats que evita o problema, e onde o arquivo deve estar.

2026-07-08

Quase todo "meu pacote aparece como incompatível" é um número em um arquivo pequeno.

O arquivo

{
  "pack": {
    "pack_format": 46,
    "description": "My pack"
  }
}

Ele deve ser nomeado exatamente pack.mcmeta e estar na raiz do arquivo .zip — ao lado de assets/ ou data/, não dentro de uma pasta dentro do .zip. Compactar a pasta que contém os arquivos em vez dos próprios arquivos é a segunda falha mais comum, e parece idêntica a um número de formato errado.

Pacotes de recursos e pacotes de dados usam números diferentes

Esta é a parte que confunde as pessoas: os dois contadores divergiram anos atrás e não são intercambiáveis. Um pacote de dados usando um número de pacote de recursos é desabilitado, mesmo que o número seja "atual".

Em vez de memorizar uma tabela que fica desatualizada a cada lançamento, leia o número de um pacote vanilla para a versão que você está buscando — ou deixe um gerador preenchê-lo.

supported_formats é a solução real

Fixar um número inteiro significa que o pacote quebra no próximo lançamento. Um intervalo não:

{
  "pack": {
    "pack_format": 46,
    "supported_formats": { "min_inclusive": 42, "max_inclusive": 99 },
    "description": "My pack"
  }
}

pack_format permanece como a declaração principal; supported_formats amplia o que o jogo aceita sem o aviso. Para um pacote que apenas adiciona texturas ou receitas — que é a maioria dos pacotes — um intervalo amplo é honesto, porque nada nele realmente quebra entre versões.

A descrição aceita componentes de texto

"description": [
  { "text": "My pack ", "color": "gold" },
  { "text": "v2", "color": "gray", "italic": true }
]

Os códigos de sinal de seção (§6) também ainda funcionam, mas o formato JSON sobrevive a operações de copiar e colar através de ferramentas que removem caracteres de controle.

Overlays, para suportar várias versões ao mesmo tempo

"overlays": { "entries": [
  { "formats": { "min_inclusive": 42, "max_inclusive": 45 }, "directory": "older" }
] }

A pasta older/ na raiz do pacote é usada apenas nesses formatos. É assim que um único download suporta duas versões com diferentes formatos de modelo, em vez de distribuir dois arquivos .zip.

Diagnóstico rápido

Uma vírgula no final é JSON inválido e produz o caso "não listado", não uma mensagem de erro.

Gere um arquivo válido para o seu tipo de pacote e versão alvo — com supported_formats preenchido — usando o Gerador pack.mcmeta.

Gerador de pack.mcmeta →