Guides / Troubleshooting

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

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

2026-07-08

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

O arquivo

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

Ele deve ser nomeado exatamente pack.mcmeta e estar na raiz do zip — ao lado de assets/ ou data/, não dentro de uma pasta dentro do zip. Compactar a pasta que o contém em vez de seu conteúdo é 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 é desativado, 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á visando — ou deixe um gerador preenchê-lo.

supported_formats é a verdadeira solução

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 amplo intervalo é 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 cópias e colagens 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 enviar dois zips.

Diagnóstico rápido

Uma vírgula à direita é JSON inválido e produz o caso "não listado de forma alguma", 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 →