Guides / Dépannage

Un addon Bedrock est un zip, et le manifeste explique pourquoi il échoue

La plupart des imports .mcaddon rejetés sont des zip valides avec une seule ligne d'en-tête erronée, et le message d'erreur ne nomme jamais le champ fautif.

2026-09-17

Un .mcaddon est une archive zip avec une extension différente, et le jeu la rejette pour des raisons qui n'ont rien à voir avec le zip. Le coupable habituel est manifest.json — un petit fichier dont l'en-tête comporte deux UUID qui doivent être distincts et dont le format_version ne correspond pas à la version du jeu que vous ciblez.

Deux UUID, jamais le même

Un manifeste contient un header et un tableau modules. Chacun a besoin de son propre uuid, et réutiliser le même pour les deux est le rejet le plus fréquent :

{
  "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]
    }
  ]
}

Les UUID sont des valeurs de 128 bits écrites sous forme de 32 chiffres hexadécimaux répartis en cinq groupes séparés par des tirets. N'importe quel générateur fait l'affaire ; un doublon, non. version et min_engine_version sont des tableaux de trois entiers, pas des chaînes de caractères — "1.0.0" échoue silencieusement sur certaines versions.

Java n'a aucun manifeste

C'est la différence qui piège ceux qui passent d'une édition à l'autre. Un pack de ressources Java fournit un pack.mcmeta avec un entier pack_format. Bedrock fournit manifest.json avec des UUID et une liste de modules. Aucun des deux fichiers n'est lu par l'autre édition, et un pack ne peut pas être porté en renommant l'archive.

Vérifiez avant d'importer

Décompressez l'archive et regardez le niveau supérieur. Un pack imbriqué d'un dossier — MyPack/manifest.json au lieu de manifest.json — s'importe comme rien du tout, sans erreur. Le manifeste doit se trouver à côté du contenu textures/ ou behavior_packs/ qu'il décrit.

Les modèles de blocs sont un format distinct

Un modèle de bloc Java au format JSON n'est pas un fichier de géométrie Bedrock, et les deux ne sont pas interchangeables :

Les deux expriment une grille de cubes de 16 unités par bloc, ce qui explique qu'un modèle généré soit correct dans l'un et s'importe comme une forme vide dans l'autre.

Les noms de registre ne sont pas interchangeables

Bedrock et Java ne s'accordent pas sur les identifiants d'un même contenu. Un pack qui référence un nom Java pour un enchantement, un effet ou un biome se chargera puis ne fera silencieusement rien, car le nom ne correspond à aucune entrée. Les registres eux-mêmes diffèrent en taille entre les éditions, donc un pack conçu d'après la liste d'une édition ne peut pas être supposé complet dans l'autre.

Validez le manifeste, vérifiez l'arborescence de l'archive et générez un modèle de bloc dans les Bedrock & Pack Tools.

Bedrock & Pack Tools →