Un addon Bedrock se compose généralement d’un behavior pack (le comportement) et d’un resource pack (l’apparence). Sur BDS, contrairement au jeu solo, un double-clic ne suffit pas : il faut déposer les packs et les déclarer pour le monde visé. Pour comprendre ce que recouvrent ces termes, lisez d’abord notre page sur les addons.

Étape 1 : récupérer l’addon à une source fiable

Téléchargez-le depuis une source connue, comme CurseForge ou MCPEDL, et vérifiez qu’il est compatible avec votre version. Un addon peut contenir des scripts exécutés par votre serveur : ne l’installez pas s’il provient d’une source inconnue. Les fichiers .mcaddon et .mcpack sont de simples archives ZIP.

Étape 2 : décompresser les packs

Un .mcaddon contient souvent deux dossiers, chacun avec son propre manifest.json. Arrêtez le serveur, puis placez-les ainsi :

bedrock/
├── behavior_packs/
│   └── MonAddon_BP/
│       └── manifest.json
└── resource_packs/
    └── MonAddon_RP/
        └── manifest.json

Pour un .mcpack seul, le manifest.json indique le type du pack : data ou script pour un behavior pack, resources pour un resource pack. Le fichier doit se trouver directement dans le dossier du pack.

Étape 3 : relever l’UUID et la version

Ouvrez chaque manifest.json, et notez les valeurs de la section header :

{
  "format_version": 2,
  "header": {
    "name": "Mon addon",
    "uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "version": [1, 0, 0]
  }
}

Prenez bien l’uuid du header, pas ceux de la section modules.

Étape 4 : déclarer les packs dans le monde

Dans le dossier du monde (worlds/NomDuMonde/), créez ou complétez world_behavior_packs.json :

[
  {
    "pack_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "version": [1, 0, 0]
  }
]

Faites de même pour le resource pack, avec son propre UUID et sa propre version, dans world_resource_packs.json. Le dossier du monde n’existe qu’après un premier démarrage du serveur : lancez-le une fois si besoin.

Étape 5 : régler le téléchargement des ressources

Pour que tous les joueurs voient les textures de l’addon, indiquez-le dans server.properties :

texturepack-required=true

Les joueurs téléchargent alors le pack à la connexion. Gardez des packs légers : sur mobile, un gros téléchargement fait fuir.

Étape 6 : activer les messages d’erreur

Pour faciliter le diagnostic, ajoutez ces lignes à server.properties :

content-log-console-output-enabled=true
content-log-file-enabled=true

Étape 7 : démarrer et vérifier

Démarrez le serveur, puis lisez la console. Rejoignez la partie et testez une fonction de l’addon.

Certains addons demandent d’activer des fonctions expérimentales. Le monde doit alors avoir été créé ou modifié dans le jeu avec ces options : préparez le monde en solo, puis transférez-le sur le serveur. Une fois activées, ces options ne se désactivent pas facilement. Sauvegardez avant.

L’ordre des packs

Si plusieurs packs modifient la même chose, l’ordre de déclaration peut changer le résultat. En cas de comportement inattendu, testez les addons un par un, puis inversez leur ordre.

Avec PowerNukkitX

PowerNukkitX prend en charge une partie des fonctions des addons, et non leur totalité. Il dispose en revanche de son propre système de plugins, à déposer dans plugins/. Vérifiez la compatibilité dans la documentation de chaque extension.

Problèmes fréquents

L’addon ne se charge pas. Vérifiez l’UUID et la version : ils doivent correspondre exactement au manifest.json. Une virgule en trop invalide tout le fichier JSON.

L’addon a cessé de fonctionner après une mise à jour. Les vérifications sont plus strictes depuis la 26.60, notamment sur les entités. Lisez les erreurs de la console et cherchez une version à jour.

Les textures n’apparaissent pas. Vérifiez world_resource_packs.json et texturepack-required. Côté client, le joueur doit accepter le téléchargement dans ses paramètres.

Le dossier a un niveau de trop. Le manifest.json doit être directement à la racine du dossier du pack, et non dans un sous-dossier.

Ajouter un addon ou un behavior pack sur un serveur Bedrock