Quand ça casse

Tous les créateurs d'add-ons cassent un pack de temps en temps. La bonne nouvelle, c'est que Minecraft te dit ce qui ne va pas, si tu sais où regarder. Cette page t'explique comment trouver les erreurs et corriger les plus courantes.

Étape 1 : active le journal de contenu

Le journal de contenu (Content Log) est la liste des problèmes que Minecraft a trouvés en chargeant tes packs. Active-le une fois et laisse-le activé pendant que tu crées.

1. Ouvre Minecraft et va dans Paramètres.
2. Ouvre la section Créateur.
3. Active Activer l'interface du journal de contenu.
4. Active Activer le fichier du journal de contenu si tu veux aussi que les erreurs soient enregistrées dans un fichier.

Désormais, quand tu charges un monde avec un pack cassé, les erreurs s'affichent à l'écran. Tu peux ouvrir la liste complète à tout moment depuis le menu pause, ou avec Ctrl + H sur un clavier.

Comment lire une erreur

Une ligne du journal de contenu ressemble en général à ça :

[Item][error]-demo:ruby | items/ruby.json | minecraft:item | components | minecraft:max_stack_size | ...

Lis-la de gauche à droite :

• [Item] : le système qui s'est plaint (Item, Blocks, Entity, Json, Texture...).
• [error] ou [warning] : les erreurs cassent en général quelque chose, les avertissements pas forcément.
• Le chemin : le fichier, puis l'endroit exact à l'intérieur. Il te dit où regarder.

Le pack n'apparaît pas du tout

Si ton pack n'est pas dans la liste des paramètres du monde, Minecraft n'a pas pu lire son manifeste.

• JSON cassé dans manifest.json. Cherche les virgules manquantes, les virgules en trop et les mauvais guillemets. Voir Le JSON en 5 minutes.
• Manifeste au mauvais endroit. Il doit se trouver directement dans le dossier du pack, comme development_behavior_packs/MyPack/manifest.json. Un dossier trop profond et le pack devient invisible.
• Mauvais type de module. Un pack de comportements utilise "type": "data", un pack de ressources "type": "resources". Un BP dans le dossier des packs de ressources (ou l'inverse) ne s'affichera pas.
• Échec de l'importation. Si un .mcpack affiche « Échec de l'importation », le manifeste est sûrement dans un sous-dossier du ZIP. Compresse le contenu du dossier du pack, pas le dossier lui-même. Voir Exporter et jouer.

UUID en double

Chaque en-tête de pack et chaque module a besoin de son propre UUID. Les problèmes arrivent quand :

• tu as copié un manifeste d'un tutoriel ou d'un autre pack et gardé ses UUID
• tu as copié ton propre manifeste de BP pour faire le RP et oublié de les changer
• une ancienne copie du même pack est encore installée

Les symptômes : un pack qui refuse de s'importer, le mauvais pack qui se charge, ou tes changements qui n'apparaissent jamais. La solution : génère quatre UUID tout neufs et vérifie que l'entrée dependencies du BP pointe vers le nouvel UUID d'en-tête du RP. Ensuite, supprime les anciennes copies du pack dans behavior_packs et resource_packs.

Les changements n'apparaissent pas

Tu as modifié un fichier mais rien n'a changé en jeu.

1. Le fichier est-il enregistré ? Active l'enregistrement automatique dans ton éditeur.
2. Modifies-tu la bonne copie ? Si tu as importé le pack en .mcpack, le jeu utilise la copie importée dans behavior_packs, pas ton dossier de projet. Travaille plutôt dans les dossiers de développement.
3. As-tu augmenté la version ? Quand tu importes un .mcpack mis à jour, augmente la version dans l'en-tête du manifeste, sinon Minecraft risque de garder l'ancien.
4. As-tu rechargé ? Quitte le monde et rouvre-le. Pour les cas tenaces, ferme complètement Minecraft.

Le pack est activé, mais rien ne marche

• Un seul pack est actif. Ouvre les paramètres du monde et vérifie que le pack de comportements et le pack de ressources sont tous les deux dans Actifs. Ajouter une dépendance du BP vers le RP rend ça automatique.
• Expérience nécessaire. Si la fonctionnalité utilisée est expérimentale, son option doit être activée dans les paramètres Expériences du monde.
• Mauvaise format_version. Si un fichier indique "format_version": "1.10" mais utilise des composants plus récents, le jeu le lit avec les anciennes règles et ignore ou rejette ce qu'il ne connaît pas. Utilise une version actuelle, comme "1.26.30" pour les objets, et calque-toi sur les exemples de ce wiki.

L'objet n'est pas dans le menu créatif

Ton objet existe, mais tu ne le trouves pas dans l'inventaire créatif.

Pas de catégorie de menu

Sans menu_category, la catégorie vaut none par défaut, ce qui cache l'objet du menu créatif. Ajoute-la à la description de l'objet :

"description": {
  "identifier": "demo:ruby",
  "menu_category": {
    "category": "items"
  }
}

Les catégories où tu peux afficher un objet sont construction, equipment, items et nature.

Autres causes

• Le fichier n'a pas pu se charger. Cherche dans le journal de contenu des erreurs avec le nom de ton objet.
• Essaie la commande. Tape /give @s demo:ruby. Si elle dit que l'objet n'existe pas, le pack de comportements ne charge pas le fichier. Si tu reçois l'objet, seul le réglage du menu est faux.

Regarde aussi la référence des composants d'objet pour vérifier que chaque nom de composant est bien écrit.

Textures manquantes ou cassées

Carrés noirs et violets

Une texture en damier violet et noir veut dire que Minecraft n'a pas trouvé l'image qu'on lui a demandé d'utiliser.

• Mauvais chemin. Les chemins de texture s'écrivent sans .png et partent de la racine du pack, comme textures/items/ruby. Vérifie chaque lettre.
• Mauvaise casse. Certaines plateformes, comme Android, considèrent Ruby.png et ruby.png comme deux fichiers différents. Utilise des minuscules partout.
• Mauvais format. Enregistre en vrai PNG. Un JPG renommé en .png ne se chargera pas.
• RP non actif. Si le pack de ressources est désactivé, toutes les textures personnalisées manquent.

Objets sans icône

Si ton objet apparaît invisible ou sans icône :

1. Vérifie que minecraft:icon dans le BP utilise un nom court, comme "ruby".
2. Vérifie que ce même nom court est enregistré dans RP/textures/item_texture.json.
3. Vérifie que le chemin dans ce fichier pointe vers ton PNG.

{
  "resource_pack_name": "my_first_addon",
  "texture_name": "atlas.items",
  "texture_data": {
    "ruby": {
      "textures": "textures/items/ruby"
    }
  }
}

Noms d'objets bizarres

Si l'objet s'appelle quelque chose comme item.demo:ruby.name au lieu de « Rubis », il manque cette ligne dans le fichier de langue. Ajoute-la à RP/texts/en_US.lang :

item.demo:ruby.name=Ruby

Une liste de vérification rapide

Quand quelque chose casse et que tu ne sais pas pourquoi, passe cette liste dans l'ordre :

1. Journal de contenu activé ? Lis la première erreur.
2. Tout le JSON est valide ?
3. Manifestes au bon endroit, avec des UUID uniques ?
4. Les deux packs actifs dans le monde ?
5. Identifiants écrits pareil partout, tout en minuscules ?
6. Chemins de texture corrects, sans .png ?
7. Monde rechargé, ou Minecraft redémarré ?

Éviter les erreurs dès le départ

La plupart de ces problèmes viennent de ce qu'on tape à la main : une virgule ici, un UUID qui ne correspond pas là, un chemin de texture avec une lettre fausse. GodCraft écrit tous ces fichiers pour toi, donc les manifestes, les UUID, les chemins de texture et les lignes de langue correspondent toujours. Si tu restes bloqué, essaie de construire la même chose dans l'Atelier GodCraft et compare.