Installer des addons et packs Bedrock sur votre serveur

Installer un addon Bedrock sur votre serveur se fait en trois étapes : décompressez le .mcaddon ou le .mcpack, placez le behavior pack dans behavior_packs/ et le resource pack dans resource_packs/, puis activez-les dans le monde via world_behavior_packs.json et world_resource_packs.json, avec l'uuid et la version tirés du manifest.json de chaque pack. Si l'addon utilise les API bêta, cette expérimentation doit aussi être activée dans le monde. Bedrock Dedicated Server n'a pas de bouton d'installation. Nous avons testé le côté serveur en version 1.26.52, la version serveur actuelle au 30 septembre 2026.

Behavior pack ou resource pack : qu'est-ce qui tourne sur le serveur ?

Un addon (appelé « extension » dans la version française du jeu) se compose généralement de deux parties. Le behavior pack (« pack de comportement » dans le jeu) contient la logique : comportement des créatures, recettes, tables de butin, fonctions et scripts. Il tourne sur le serveur. Le resource pack (« pack de ressources ») contient ce que vous voyez et entendez : textures, modèles, animations et sons. Les joueurs le reçoivent du serveur en se connectant. Un pack de textures n'est rien d'autre qu'un resource pack. Dans manifest.json, vous reconnaissez la différence au type de module : data ou script pour un behavior pack, resources pour un resource pack.

Un .mcpack contient un seul pack ; un .mcaddon en regroupe plusieurs, sous forme de dossiers ou de fichiers .mcpack, comme le décrit le wiki communautaire wiki.bedrock.dev. Ce sont des fichiers zip avec une autre extension : renommez-les en .zip et n'importe quel outil de décompression les ouvrira.

Étape 1 : décompresser l'addon et lire manifest.json

Décompressez l'addon sur votre ordinateur. Chaque dossier contenant un manifest.json est un pack ; s'il contient encore un .mcpack, décompressez-le aussi. Pour chaque pack, notez deux valeurs du bloc header :

"header": {
  "name": "Mon addon BP",
  "uuid": "0b6f7e2a-4c1d-4e5b-9a3f-2d8c7b6a5e41",
  "version": [1, 0, 0]
},
"modules": [
  { "type": "data", "uuid": "5c2e9d1b-7a3f-4b8e-a6d2-1f0e9c8b7a62", "version": [1, 0, 0] }
]

L'uuid sous modules ne vous sert pas ici : selon Microsoft, il doit justement être différent de l'uuid du pack, et si vous l'utilisez quand même, le pack ne se charge pas. Si le behavior pack renvoie à un resource pack sous dependencies, les deux doivent se trouver sur le serveur.

Étape 2 : envoyer les packs dans behavior_packs/ et resource_packs/

Arrêtez le serveur dans le panel et envoyez les dossiers décompressés : les behavior packs dans behavior_packs/, les resource packs dans resource_packs/, tous deux à la racine de votre serveur. Pour quelques fichiers, le gestionnaire de fichiers du panel suffit ; les gros addons passent plus facilement par SFTP (voir se connecter avec WinSCP ou FileZilla). Ne touchez pas aux packs par défaut, comme vanilla.

Les packs placés dans ces dossiers racine sont disponibles pour tous les mondes ; dans worlds/<monde>/behavior_packs/, ils n'appartiennent qu'à ce monde-là.

Étape 3 : activer les packs dans le monde

L'envoi seul ne suffit pas : le monde doit savoir quels packs charger. Cela se règle dans deux fichiers de worlds/<level-name>/. Le nom du dossier figure à la ligne level-name de server.properties ; par défaut, c'est Bedrock level. Dans un monde neuf, ces fichiers n'existent pas encore ; créez-les alors vous-même. world_behavior_packs.json :

[
  { "pack_id": "0b6f7e2a-4c1d-4e5b-9a3f-2d8c7b6a5e41", "version": [1, 0, 0] }
]

Et world_resource_packs.json, avec l'uuid et la version du resource pack :

[
  { "pack_id": "9e4d3c2b-1a0f-4e9d-8c7b-6a5f4e3d2c13", "version": [1, 0, 0] }
]

Plusieurs addons ? Ajoutez des lignes à la même liste, séparées par des virgules, mais sans virgule après la dernière. Recopiez la version à l'identique. Lors de notre test, le serveur ignorait le pack si le premier chiffre différait (2.0.0 au lieu de 1.0.0) ou si le JSON indiquait une version inférieure à celle du manifeste. Démarrez le serveur et regardez la console. Un behavior pack chargé ressemble à ceci :

Pack Stack - [00] Mon addon BP (id: 0b6f7e2a-..., version: 1.0.0) @ behavior_packs/monaddon_BP

Rendre les resource packs obligatoires avec texturepack-required

Avec texturepack-required=true dans server.properties, vous obligez les joueurs à utiliser les resource packs du monde ; par défaut, la valeur est false. Activez-la si votre addon ajoute ses propres blocs, objets ou créatures, car leur apparence est définie dans le resource pack. Cette clé se modifie dans le gestionnaire de fichiers ; notre panel ne réécrit à chaque démarrage, à partir des variables de démarrage, que des clés comme gamemode et difficulty.

API bêta et autres expérimentations : les activer dans le monde

Certains addons utilisent la version bêta de l'API de script. Vous le repérez dans le manifeste à une dépendance sur @minecraft/server avec une version qui se termine par -beta. L'expérimentation API bêta (Beta APIs en anglais) doit alors être activée dans le monde. Si elle est désactivée, la console affiche :

[Scripting] Plugin [Mon addon BP - 1.0.0] - requesting dependency on beta APIs [@minecraft/server - 2.11.0-beta], but the Beta APIs experiment is not enabled.

Le serveur n'a aucun paramètre pour cela. Activez donc l'expérimentation en local :

1. Arrêtez le serveur, faites une sauvegarde et téléchargez le dossier worlds/<level-name>/.
2. Compressez le contenu de ce dossier en zip, renommez le fichier en .mcworld et ouvrez-le sur votre PC ; Minecraft importe le monde.
3. Dans les paramètres du monde, sous Expérimentations, activez API bêta. Minecraft crée alors une copie avec « Copie de » devant le nom ; travaillez dans cette copie.
4. Exportez la copie en .mcworld, décompressez-la et remplacez par son contenu celui du dossier du monde sur le serveur. Vérifiez que les deux fichiers world_..._packs.json s'y trouvent toujours ; sinon, restaurez-les depuis votre sauvegarde.

Un nouveau monde, vous le créez en local directement avec l'expérimentation activée. Il existe aussi une méthode sans détour : le wiki communautaire wiki.bedrock.dev explique comment, avec un éditeur NBT, placer dans level.dat, dans le compound experiments, un byte gametest de valeur 1. Lors de notre test, cela a fonctionné ; la console affiche alors Experiment(s) active: gtst.

Attention : selon Microsoft, un monde avec des expérimentations ne redevient jamais un monde normal, et les fonctionnalités bêta peuvent changer ou disparaître lors d'une mise à jour de Bedrock, ce qui casse un tel addon jusqu'à ce que son créateur le mette à jour. Si un addon demande @minecraft/server-net, vous devez autoriser ce module. Microsoft recommande de le faire module de script par module de script, dans config/<uuid-du-module-de-script>/permissions.json, et de garder config/default/permissions.json minimal. Bon à savoir : une réinstallation via notre panel (par exemple lors d'un changement de version) remet ce fichier par défaut à zéro et laisse intacts vos propres dossiers, vos packs et votre monde.

Les addons du Marketplace ne vont pas sur votre propre serveur

Ce que vous achetez sur le Marketplace (le « Magasin » dans la version française du jeu) ne peut pas être installé sur votre propre serveur. Minecraft stocke le contenu acheté sous forme chiffrée dans un dossier à part (premium_cache, selon le wiki communautaire minecraft.wiki) : il n'y a donc rien à envoyer. Les addons que les créateurs proposent eux-mêmes en .mcaddon ou .mcpack fonctionnent, eux.

Tester : activer la journalisation du contenu et lire la console

Mettez content-log-console-output-enabled=true dans server.properties ; les erreurs des packs apparaissent alors aussi dans la console du panel. Voici les messages que nous avons vus lors de notre test :

• Uuid du module ou mauvaise version : Configured pack (id: …) was not found and was ignored, puis Pack Stack - None.
• Une virgule après la dernière ligne dans world_behavior_packs.json : aucun message d'erreur, seulement Pack Stack - None. Si rien ne se charge et que rien ne se plaint, vérifiez le JSON.
• Un .mcaddon complet dans behavior_packs/ : Multiple manifests found at the same directory level, ou, s'il contient des fichiers .mcpack, seulement was not found.
• Un behavior pack dans resource_packs/ : Defaulting to resource pack, et le pack ne fait rien.

Nouvelle version d'un addon ? Remplacez le dossier, adaptez la version dans le JSON et redémarrez.

Quand vous n'avez pas besoin d'addon

Si vous voulez seulement modifier une règle du jeu, par exemple conserver vos objets après la mort, une gamerule suffit : configurer keepInventory ne demande qu'une commande et ne rend pas votre monde expérimental. Un addon vaut la peine pour des choses vraiment nouvelles, comme des créatures personnalisées ou un chat vocal de proximité, mais les addons lourds sollicitent davantage le serveur qu'un pack de textures. Nos serveurs Bedrock font tourner le Bedrock Dedicated Server officiel, à partir de 2,50 € par mois (Apple, 2 Go) ; Cookey avec 4 Go coûte 5,00 €. Tout est résiliable mensuellement.

Questions fréquentes

Peut-on utiliser des addons sur un serveur Bedrock ?

Oui. Bedrock Dedicated Server charge les behavior packs et resource packs que vous placez dans behavior_packs et resource_packs et que vous activez dans le monde via world_behavior_packs.json et world_resource_packs.json. Seul le contenu acheté sur le Marketplace ne peut pas être installé sur votre propre serveur.

Pourquoi mon addon ne se charge-t-il pas sur mon serveur Bedrock ?

Cherchez la ligne Pack Stack dans la console. Si elle indique None avec 'Configured pack ... was not found and was ignored', l'uuid ou la version ne correspond pas : reprenez uuid et version dans le bloc header de manifest.json, pas l'uuid du module. S'il n'y a aucun message, c'est souvent une erreur dans le JSON, comme une virgule après la dernière ligne.

Comment activer les API bêta (Beta APIs) sur un Bedrock Dedicated Server ?

Pas via le serveur lui-même. Activez les API bêta en local dans les paramètres du monde et renvoyez le monde sur le serveur, ou, avec un éditeur NBT, mettez un byte gametest à 1 sous experiments dans level.dat. Faites d'abord une sauvegarde : un monde avec des expérimentations ne redevient jamais un monde normal.

Peut-on installer des addons du Marketplace sur son propre serveur ?

Non. Le contenu acheté sur le Marketplace est stocké sous forme chiffrée, vous ne pouvez donc pas l'envoyer comme pack. Les addons que le créateur propose lui-même en .mcaddon ou .mcpack fonctionnent, eux.

À lire aussi

• Chat vocal Minecraft Bedrock : ce qui fonctionne (et ce qui ne fonctionne pas)
• Bedrock 26.50 et 26.51 : pourquoi les joueurs ne peuvent plus rejoindre votre serveur (et que faire)
• Minecraft Java ou Bedrock : la différence et quel serveur choisir