Comment installer des Behavior Packs (Addons) sur Minecraft Bedrock ?

Contexte

Les Behavior Packs (addons) sur Minecraft Bedrock permettent de modifier en profondeur le gameplay de votre serveur : comportements des mobs, mécaniques de jeu, systèmes de craft, événements, et bien plus encore.

Grâce à eux, vous pouvez transformer totalement votre expérience de jeu sans avoir besoin de mods côté client.

Où trouver des Behavior Packs ?

Pour télécharger des addons fiables et compatibles Minecraft Bedrock, voici les principales sources :

🌍 MCPEDL → la référence communautaire des addons Minecraft
🌍 ModBay → addons récents et régulièrement mis à jour
📦 GitHub / Discord → projets de créateurs indépendants

Format des fichiers

Pour être installés et configurés manuellement sur votre serveur hébergé chez Winheberg, les addons doivent être manipulés sous forme d'archives compressées au format .zip.

Installation d’un Behavior Pack

1. Préparer l'archive

Assurez-vous de disposer du Behavior Pack de votre choix sous forme d'archive .zip.

2. Extraire les fichiers

• Faites un clic droit sur votre fichier .zip.
• Sélectionnez l'option d'extraction pour obtenir le dossier décompressé.

Pour que le pack soit valide, ce dossier doit impérativement contenir le fichier manifeste à sa racine :

manifest.json

3. Envoyer le pack sur le serveur

1. Connectez-vous à votre panel.winheberg.com.
2. Sélectionnez votre instance et ouvrez le File Manager (Gestionnaire de fichiers).
3. Accédez au dossier de votre monde actuel.

Déposez le dossier extrait de votre Behavior Pack dans le répertoire suivant :

behavior_packs

4. Traiter le Resource Pack (optionnel)

Si votre addon inclut également des éléments visuels ou des textures, vous devez séparer la partie visuelle et la placer dans le dossier :

resource_packs

Activation des addons sur le monde

L'importation des fichiers ne suffit pas ; le moteur du serveur doit indexer vos addons via un fichier de configuration pour les charger au démarrage.

1. Accéder aux fichiers du monde

Depuis le File Manager :

• Allez dans le répertoire racine de votre serveur.
• Ouvrez le dossier world (ou le nom personnalisé de votre carte active).

2. Créer le fichier de configuration

Dans le dossier de votre monde, créez un nouveau document nommé exactement :

world_behavior_packs.json

Ouvrez-le et appliquez la structure JSON suivante :

[
  {
    "pack_id": "UUID_DU_PACK",
    "version": [1, 0, 0]
  }
]

3. Récupérer l'UUID et la version

Pour remplir correctement le fichier JSON, ouvrez le document manifest.json situé à la racine du dossier de votre addon (extrait de votre .zip).

4. Cumuler plusieurs addons

Pour activer plusieurs packs simultanément, séparez les blocs de données par une virgule en respectant la syntaxe des tableaux JSON :

[
  {
    "pack_id": "UUID_DU_PACK_1",
    "version": [1, 0, 0]
  },
  {
    "pack_id": "UUID_DU_PACK_2",
    "version": [1, 2, 0]
  }
]

Resource Packs (textures associées)

Si votre addon nécessite obligatoirement ses textures pour fonctionner :

• Validez que la partie visuelle est bien envoyée dans le dossier général resource_packs.
• Créez un second fichier de configuration dans le dossier de votre monde nommé :

world_resource_packs.json

Reprenez la même structure et les identifiants issus du manifeste de la partie des ressources.

En cas de problème

❌ Le serveur crash au démarrage ou refuse de se lancer

• Erreur de syntaxe JSON : Le format JSON est extrêmement strict. Une virgule manquante à la fin d'une ligne ou une accolade mal fermée dans votre fichier world_behavior_packs.json fera crasher l'instance. Utilisez un validateur JSON en ligne pour vérifier votre fichier.
• Incompatibilité de version : Vérifiez que l'addon prend en charge la version actuelle de Minecraft Bedrock installée sur votre serveur.

❌ L'addon est totalement ignoré et n'apparaît pas en jeu

• Arborescence interne incorrecte : Ouvrez votre dossier dans behavior_packs. Le fichier manifest.json doit se trouver immédiatement à la racine de ce dossier. S'il est enfermé dans un sous-dossier intermédiaire créé lors de l'extraction, le serveur ne pourra pas le lire.

❌ Les textures de l'addon s'affichent sous forme de blocs violets et noirs

• Resource Pack manquant ou mal déclaré : La majorité des addons de gameplay nécessitent obligatoirement leur pack de textures jumelé pour s'afficher correctement. Vérifiez que la partie ressources est bien présente dans le dossier racine resource_packs et correctement listée dans le fichier world_resource_packs.json de votre monde.

Bonnes pratiques d'administration

• Priorité aux sauvegardes : Avant d'injecter un nouvel addon ou de modifier vos fichiers de configuration JSON, effectuez systématiquement une sauvegarde complète depuis l'onglet Backups de votre panel. Un addon corrompu ou mal configuré peut endommager définitivement les données de votre monde.
• Gestion des conflits : Si vous utilisez plusieurs Behavior Packs qui modifient les mêmes entités (par exemple, le comportement des Zombies), sachez que l'ordre dans le fichier JSON détermine la priorité. Le pack placé le plus bas dans la liste écrasera les modifications des packs situés au-dessus de lui.
• Nettoyage des UUID : Ne dupliquez jamais manuellement un bloc JSON existant en modifiant seulement le nom. Chaque addon possède son propre identifiant unique (UUID) généré par son créateur dans son manifeste.

Besoin d’aide ?

La mise en place d'éléments de gameplay personnalisés demande une grande rigueur dans l'arborescence des dossiers et l'écriture des fichiers JSON.

Si votre serveur refuse de démarrer après vos modifications ou si les fichiers de configuration restent inopérants, notre équipe technique est à vos côtés. Ouvrez un ticket d'assistance depuis votre espace client sur billing.winheberg.com pour obtenir une aide personnalisée.

Bonne configuration et bon jeu sur votre serveur de jeu ! 🎮