MC Toolkit

Guides / Dépannage

Un addon Bedrock est un zip, et le manifeste est la raison de son échec

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.

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 le manifest.json — un petit fichier avec un UUID d'en-tête et un UUID de module qui doivent être distincts, et une format_version qui 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 courant :

{
  "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 — "1.0.0" est refusé.

Java n'a pas de manifeste du tout

C'est la divergence qui piège ceux qui passent d'une édition à l'autre. Un pack de ressources Java fournit un pack.mcmeta déclarant les formats qu'il prend en charge (min_format et max_format sur les versions actuelles). 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 à la racine de chaque pack, à côté des dossiers qu'il décrit.

Les modèles de blocs sont un format distinct

Un JSON de modèle de bloc Java n'est pas un fichier de géométrie Bedrock, et les deux ne sont pas interchangeables. Un modèle Java n'est généralement qu'un parent plus une map textures — une liste elements de cuboïdes n'est nécessaire que pour une forme personnalisée — tandis que Bedrock décrit les formes dans son propre format minecraft:geometry. Les deux mesurent 16 unités par bloc, ce qui explique qu'un modèle peut sembler correct dans une édition et s'importer comme rien dans l'autre.

Les noms de registre ne sont pas interchangeables

Bedrock et Java ne s'accordent pas sur les identifiants pour le 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 présumé 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.

Outils Bedrock et packs →

Plus de guides

Tout voir →