Qu'est-ce qu'un add-on ?

Un add-on est un ensemble de fichiers qui modifie Minecraft Bedrock Edition. Il peut ajouter de nouveaux objets, blocs, créatures, recettes et sons, ou changer des choses qui existent déjà dans le jeu. Pas besoin de modifier le jeu lui-même : Minecraft lit tes fichiers et les charge par-dessus le jeu normal.

Le meilleur, c'est que les add-ons sont faits de simples fichiers texte et d'images. Si tu sais modifier un fichier texte et dessiner une image de 16x16, tu peux créer un add-on.

Deux types de packs

La plupart des add-ons sont composés de deux packs qui travaillent en équipe.

Pack de comportements (BP)

Le pack de comportements contrôle la façon dont les choses fonctionnent. Il se trouve du côté "serveur" du jeu, ce qui veut dire qu'il fixe les règles :

• combien de dégâts inflige une épée
• combien de faim rend un aliment
• ce que fait une créature quand elle voit un joueur
• quels objets une recette d'artisanat demande
• ce qui tombe quand on casse un bloc

Les packs de comportements sont surtout des fichiers JSON, avec des fichiers .mcfunction pour les commandes et des fichiers JavaScript pour les scripts.

Pack de ressources (RP)

Le pack de ressources contrôle l'apparence et les sons. Il tourne du côté "client", sur l'appareil de chaque joueur :

• les textures (les images des objets, des blocs et des créatures)
• les modèles 3D et les animations
• les sons et la musique
• les noms que tu vois en jeu, dans toutes les langues
• les particules et certains menus

Pourquoi deux packs ?

Séparer l'apparence et les règles rend les packs flexibles. Un pack de textures, c'est juste un pack de ressources sans pack de comportements. Un pack qui change seulement le comportement des créatures peut se limiter à un pack de comportements. Quand tu ajoutes quelque chose de tout nouveau, comme une épée personnalisée, il te faut généralement les deux : le BP dit que l'objet existe et comment il fonctionne, le RP lui donne une texture et un nom.

Voici un petit exemple. Ce fichier du pack de comportements crée un nouvel objet :

{
  "format_version": "1.26.30",
  "minecraft:item": {
    "description": {
      "identifier": "demo:ruby",
      "menu_category": {
        "category": "items"
      }
    },
    "components": {
      "minecraft:icon": {
        "textures": {
          "default": "ruby"
        }
      },
      "minecraft:max_stack_size": 64
    }
  }
}

Le nom d'icône "ruby" renvoie à une image enregistrée dans le pack de ressources. Sans le pack de ressources, l'objet existerait quand même, mais il n'aurait pas de texture. Tu construiras cet objet étape par étape dans Ton premier objet personnalisé.

Que peux-tu modifier ?

Les add-ons permettent de faire beaucoup de choses. Voici les principales que tu vas apprendre sur ce wiki :

Chaque nouvel élément est construit à partir de composants. Un composant est une petite fonctionnalité, comme "cet objet peut être mangé" ou "ce bloc émet de la lumière". Tu empiles les composants comme des briques de construction. La référence des composants d'objet les liste tous avec des exemples.

Les types de fichiers que tu vas croiser

Quand tu télécharges un add-on, il se présente généralement sous l'une de ces formes :

• .mcpack : un seul pack (un pack de comportements ou un pack de ressources). C'est en réalité un fichier .zip avec un autre nom.
• .mcaddon : un paquet qui contient plusieurs packs, en général un BP et son RP ensemble. C'est aussi un .zip renommé.
• .mcworld et .mctemplate : des mondes complets et des modèles de monde, qui peuvent contenir des packs.

Quand tu ouvres l'un de ces fichiers, Minecraft l'importe automatiquement. Tu apprendras à les créer dans Exporter et jouer.

Ça marche partout

Bedrock Edition tourne sur Windows, Android, iPhone et iPad, Xbox, PlayStation et Nintendo Switch. Les add-ons utilisent les mêmes fichiers sur toutes ces plateformes. Un pack créé sur ton téléphone fonctionne sur le PC d'un ami, et un pack créé sur PC fonctionne sur un téléphone.

Il y a quelques limites à connaître :

• Sur console, tu ne peux pas importer tes propres fichiers directement. Tu peux quand même y jouer avec des add-ons sur un Realm, sur un serveur ou depuis le Marketplace.
• Certaines fonctionnalités sont marquées comme expérimentales. Elles ne marchent que si l'expérience correspondante est activée dans le monde. La plupart des objets, blocs et créatures n'ont plus besoin d'aucune expérience.

Deux façons de créer un add-on

À la main. Tu crées des dossiers, tu écris du JSON dans un éditeur de texte, tu dessines des textures dans un éditeur d'images, puis tu compresses le tout. Ce wiki t'apprend chaque étape, et comprendre le fonctionnement des fichiers est une super compétence.

La méthode facile. GodCraft est une application gratuite pour iPhone et Android qui crée des add-ons sans code. Tu ouvres l'Atelier, tu ajoutes des éléments comme des objets, des blocs ou des créatures, et tu remplis des formulaires simples. L'appli écrit tout le JSON, les manifestes et les UUID pour toi et exporte un .mcaddon qui s'ouvre directement dans Minecraft.

Tu peux combiner les deux méthodes. Beaucoup de créateurs commencent dans GodCraft pour obtenir rapidement un pack qui marche, puis lisent ce wiki pour comprendre à quoi sert chaque fichier.

À lire ensuite

1. Les outils nécessaires : quoi installer, ou comment tout faire depuis ton téléphone.
2. Ton premier pack : crée les dossiers et les manifestes.
3. Le JSON en 5 minutes : le format de fichier utilisé par tous les add-ons.
4. Exporter et jouer : mets ton pack dans le jeu.