Ton premier pack

Dans ce guide, tu vas créer un add-on vide que Minecraft reconnaît. Il n'ajoutera rien pour l'instant, mais c'est la base de tous les objets, blocs et créatures que tu feras ensuite. Compte environ dix minutes.

L'arborescence des dossiers

Crée un dossier de projet où tu veux, par exemple sur ton bureau. À l'intérieur, crée deux dossiers : un pour le pack de comportements et un pour le pack de ressources.

my_first_addon/
  BP/
    manifest.json
    pack_icon.png
    items/
  RP/
    manifest.json
    pack_icon.png
    textures/
    texts/

Les noms BP et RP sont juste une habitude prise par la plupart des créateurs. Minecraft se moque du nom des dossiers extérieurs. Seul compte ce qu'ils contiennent, et le fichier le plus important est manifest.json.

À quoi sert un manifeste

Chaque pack a besoin d'un manifest.json dans son dossier principal. Il indique à Minecraft :

• le nom et la description du pack
• un identifiant unique (l'UUID) pour que le jeu puisse distinguer les packs
• la version du pack
• le type de pack (comportements ou ressources)
• les autres packs dont il a besoin

Si le manifeste est absent ou cassé, Minecraft n'affichera pas du tout le pack.

Les UUID

Un UUID est un long identifiant aléatoire qui ressemble à ceci : 7da910dc-081d-41d2-84e6-fcd9e04cbffb. Chaque pack a besoin de ses propres UUID, et deux packs ne doivent jamais en partager un.

Il te faut quatre UUID pour un add-on BP + RP :

1. En-tête du pack de comportements
2. Module du pack de comportements
3. En-tête du pack de ressources
4. Module du pack de ressources

Pour les obtenir, cherche "UUID generator" dans ton navigateur et copie quatre UUID tout neufs. Dans VS Code, les extensions pour Bedrock peuvent aussi en générer.

Le manifeste du pack de comportements

Crée BP/manifest.json, colle ceci, puis remplace les UUID par les tiens :

{
  "format_version": 2,
  "header": {
    "name": "My First Add-on",
    "description": "My very first behavior pack",
    "uuid": "7da910dc-081d-41d2-84e6-fcd9e04cbffb",
    "version": [1, 0, 0],
    "min_engine_version": [1, 26, 50]
  },
  "modules": [
    {
      "type": "data",
      "uuid": "92b4a8c1-cbc4-4b82-85bd-e36e922d0621",
      "version": [1, 0, 0]
    }
  ],
  "dependencies": [
    {
      "uuid": "f67430fa-ef89-4f40-802d-9574599c764d",
      "version": [1, 0, 0]
    }
  ]
}

Le manifeste du pack de ressources

Crée RP/manifest.json. Remarque que le type de module est différent, et que l'UUID de l'en-tête correspond à celui indiqué dans les dependencies du pack de comportements :

{
  "format_version": 2,
  "header": {
    "name": "My First Add-on",
    "description": "My very first resource pack",
    "uuid": "f67430fa-ef89-4f40-802d-9574599c764d",
    "version": [1, 0, 0],
    "min_engine_version": [1, 26, 50]
  },
  "modules": [
    {
      "type": "resources",
      "uuid": "654e78d1-0b0d-4f13-9a3b-6336f0ceab13",
      "version": [1, 0, 0]
    }
  ]
}

Chaque champ expliqué

format_version

La version du format du manifeste lui-même. Utilise 2, comme les packs vanilla de Mojang. C'est un simple nombre, pas du texte entre guillemets.

header

Les informations sur le pack dans son ensemble.

• name : affiché dans la liste des packs en jeu.
• description : le petit texte sous le nom.
• uuid : l'identifiant unique du pack.
• version : trois nombres : majeure, mineure, correctif. Augmente-la quand tu publies une mise à jour, par exemple de [1, 0, 0] à [1, 0, 1]. Minecraft s'en sert pour savoir qu'un pack est plus récent.
• min_engine_version : la version de Minecraft la plus ancienne pour laquelle ton pack est écrit. Elle détermine aussi la façon dont le jeu lit certains de tes fichiers, alors mets la version sur laquelle tu testes, comme [1, 26, 50].

modules

Ce que contient le pack. Un pack a besoin d'au moins un module, et chaque module a son propre UUID.

dependencies

La liste des autres packs dont celui-ci a besoin. Chaque entrée contient l'uuid et la version de l'en-tête de l'autre pack.

Ici, le pack de comportements dépend du pack de ressources. Ce lien a un effet bien pratique : quand tu actives le pack de comportements dans un monde, Minecraft active aussi le pack de ressources pour toi. Sans ce lien, les joueurs pourraient activer le BP seul et voir des objets sans texture.

Les icônes de pack

Ajoute un pack_icon.png en haut de chaque dossier de pack, à côté du manifeste. C'est l'image affichée dans la liste des packs.

• Fais-la carrée. 128x128 ou 256x256 pixels, les deux rendent bien.
• Enregistre-la en PNG.
• Tu peux utiliser la même image pour les deux packs.

S'il n'y a pas d'icône, le pack fonctionne quand même, mais il affiche une image vide par défaut.

Ajouter un fichier de langue

Les noms affichés en jeu viennent des fichiers de langue du pack de ressources. Crée ces deux fichiers dès maintenant pour qu'ils soient prêts pour les prochains guides :

["en_US"]

pack.name=My First Add-on
pack.description=My very first add-on

Plus tard, tu ajouteras ici des lignes comme item.demo:ruby.name=Ruby.

Vérifier que le pack se charge

1. Copie le dossier BP dans com.mojang/development_behavior_packs.
2. Copie le dossier RP dans com.mojang/development_resource_packs.
3. Ouvre Minecraft et crée un nouveau monde.
4. Dans les paramètres du monde, ouvre Packs de comportements et regarde dans Disponibles. Ton pack devrait y être, avec son icône.
5. Active-le. Le pack de ressources devrait s'activer tout seul, grâce à la dépendance.

Si le pack n'apparaît pas, consulte Quand ça ne marche pas. La cause la plus probable est une faute de frappe dans un manifeste, alors lis ensuite Le JSON en 5 minutes.

La méthode facile

Écrire les manifestes et générer les UUID à la main, c'est une corvée à faire une seule fois par projet, mais c'est aussi là que de petites fautes de frappe cassent tout. GodCraft s'en charge pour toi : chaque add-on que tu crées dans l'Atelier reçoit ses propres UUID tout neufs, les deux manifestes et le lien de dépendance entre les deux packs. Tu n'as qu'à remplir les détails qui t'intéressent dans les paramètres du pack.

Étapes suivantes

Ton add-on vide fonctionne. Maintenant, donne-lui quelque chose à faire :

• Ton premier objet personnalisé
• Bloc personnalisé
• Exporter et jouer pour le partager avec tes amis