← Tous les articles

D’un modèle Blockbench à un objet en jeu : export, chemins du pack et branchement

Blockbench crée le modèle ; le resource pack décide quel objet l’affiche. Le fichier du modèle est le même dans toutes les versions depuis la 1.13, mais la façon d’indiquer à un objet quel modèle utiliser a changé en 1.21.4 : la dernière étape dépend donc de votre version.

Vérifié pour les versions : Java Edition 1.20 à 26.3. Les formats Bedrock de Blockbench ne fonctionnent pas en Java Edition.

Dans Blockbench

Où vont les fichiers

my_pack/
  pack.mcmeta
  assets/cube/
    items/guild_hammer.json          (1.21.4+ only)
    models/item/guild_hammer.json    (exported from Blockbench)
    textures/item/guild_hammer.png

Utilisez votre propre espace de noms (ici cube) plutôt que minecraft pour les nouveaux fichiers, afin d’éviter toute collision avec les ressources vanilla ou un autre pack.

Brancher l’objet en 1.21.4 et au-delà

Une item definition dans items/ indique quel modèle dessiner :

{
  "model": {
    "type": "minecraft:model",
    "model": "cube:item/guild_hammer"
  }
}

L’objet pointe vers ce fichier avec le composant item_model, écrit de la même façon en 1.21.4 et en 1.21.5 – 26.x :

/give @p minecraft:stick[minecraft:item_model="cube:guild_hammer"] 1

Un modèle peut servir plusieurs états d’un objet (chargé, cassé, couleurs de faction) via select, range_dispatch ou condition dans la définition ; le constructeur item_model écrit ces fichiers.

Brancher l’objet en 1.21.3 et avant

Les versions plus anciennes n’ont pas de dossier items/. Le modèle de l’objet vanilla reçoit à la place un override qui bascule selon CustomModelData, dans assets/minecraft/models/item/stick.json :

{
  "parent": "minecraft:item/handheld",
  "textures": { "layer0": "minecraft:item/stick" },
  "overrides": [
    { "predicate": { "custom_model_data": 1 }, "model": "cube:item/guild_hammer" }
  ]
}

La commande fixe ensuite le nombre, en composants en 1.20.5 – 1.21.3 ou en NBT avant :

/give @p minecraft:stick[minecraft:custom_model_data=1] 1
/give @p minecraft:stick{CustomModelData:1} 1

Depuis la 1.21.4, les overrides sont ignorés : c’est la raison la plus fréquente pour laquelle un pack qui « marchait l’an dernier » n’affiche plus que des objets vanilla.

Quand rien n’apparaît

Questions fréquentes

Un modèle peut-il servir à plusieurs objets ?

Oui. Plusieurs item definitions, ou plusieurs overrides, peuvent pointer vers le même fichier de modèle.

La texture peut-elle être animée ?

Oui, avec une bande verticale d’images dans le PNG et un fichier .png.mcmeta à côté qui fixe la durée de chaque image.

Quel objet de base doit porter le modèle ?

Celui dont le comportement convient : un bâton ou une carotte sur un bâton pour les accessoires, une épée ou une hache pour les armes, du papier pour les documents. Le modèle ne change que l’apparence.