Guides / Dépannage

pack.mcmeta : numéros de pack_format et avertissement « incompatible »

Un seul champ mal renseigné et Minecraft grise votre pack. Voici la structure exigée par la version 26.x, comment couvrir anciennes et nouvelles versions dans un même fichier, et où ce fichier doit se trouver.

2026-07-08

Presque tous les « mon pack est marqué comme incompatible » viennent d'un seul champ dans un seul petit fichier.

Le fichier

{
  "pack": {
    "min_format": 97,
    "max_format": 97,
    "description": "My pack"
  }
}

Il s'agit d'un pack de ressources 26.3 ; un pack de données 26.3 utilise 121. Depuis la 1.21.9, tout format au-delà de 64 (ressources) ou 81 (données) doit être déclaré avec min_format et max_format. Un pack qui écrit encore un simple "pack_format": 97 — ce que montrent toujours la plupart des tutoriels et des générateurs — est refusé et s'affiche comme incompatible.

Le fichier doit porter exactement le nom pack.mcmeta et se trouver à la racine du zip — à côté de assets/ ou data/, et non dans un dossier à l'intérieur du zip. Compresser le dossier conteneur au lieu de son contenu est la deuxième erreur la plus fréquente, et le résultat est identique à celui d'un mauvais numéro de format.

Packs de ressources et packs de données n'utilisent pas les mêmes numéros

C'est le point qui piège : les deux compteurs ont divergé il y a des années et ne sont pas interchangeables. Un pack de données qui utilise un numéro de pack de ressources est grisé, même si ce numéro est « actuel ».

Plutôt que de mémoriser un tableau qui devient obsolète à chaque version, lisez le numéro sur un pack vanilla correspondant à la version visée — ou laissez un générateur le remplir.

Un seul fichier pour anciennes et nouvelles versions

Fixer un seul numéro signifie que le pack casse à la prochaine version. Une plage, non — mais une plage qui atteint les 26.x doit être écrite pour deux générations du jeu à la fois :

{
  "pack": {
    "pack_format": 46,
    "supported_formats": { "min_inclusive": 46, "max_inclusive": 64 },
    "min_format": 46,
    "max_format": 97,
    "description": "My pack"
  }
}

min_format/max_format est la plage lue par les 26.x. pack_format et supported_formats ne sont là que pour les clients antérieurs à la 1.21.9 : supported_formats doit se terminer exactement à 64 (81 pour un pack de données), min_format doit être égal à sa borne inférieure, et pack_format doit se situer à l'intérieur. L'ancien conseil — supported_formats jusqu'à un grand nombre comme 99 — est désormais la seule forme que les 26.x refusent d'emblée. Pour un pack qui ne fait qu'ajouter des textures ou des recettes — la majorité des packs — une plage large est honnête, car rien en son sein ne casse réellement d'une version à l'autre.

La description accepte les composants textuels

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

Les codes à signe de section (§6) fonctionnent aussi, mais la forme JSON survit au copier-coller à travers les outils qui suppriment les caractères de contrôle.

Les overlays, pour prendre en charge plusieurs versions à la fois

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

Le dossier older/ à la racine du pack n'est utilisé que sur ces formats. C'est ainsi qu'un seul téléchargement prend en charge deux versions aux formats de modèles différents, au lieu de livrer deux zips.

Diagnostic rapide

Une virgule finale rend le JSON invalide et produit le cas « absent de la liste », et non un message d'erreur.

Générez un fichier valide pour votre type de pack et votre version cible — avec min_format/max_format, et les champs hérités là où une version plus ancienne les exige — à l'aide du générateur pack.mcmeta.

Générateur de pack.mcmeta →