Guide Minecraft sur le CustomModelData : définition et fonctionnement

Qu’est-ce que CustomModelData ?

Ajouté dans Minecraft 1.14, CustomModelData permet aux créateurs de packs d’associer différentes textures ou modèles 3D à un objet vanilla avec des identifiants numériques.

• Sans tags, une épée en fer ressemble à l’épée vanilla normale.
• Avec CustomModelData: 1, elle peut ressembler à un katana.
• Avec CustomModelData: 2, elle peut être rendue comme une tronçonneuse 3D.

Pour le serveur et les mécaniques du jeu, cela reste une épée en fer. Seule l’apparence côté client change.

Comment ça marche

Le pack de ressources utilise des overrides de modèles d’objets. Le modèle de base indique au jeu de charger un autre modèle quand une valeur CustomModelData précise est présente.

{
  "parent": "item/handheld",
  "textures": { "layer0": "item/iron_sword" },
  "overrides": [
    { "predicate": { "custom_model_data": 1 }, "model": "item/custom_katana" },
    { "predicate": { "custom_model_data": 2 }, "model": "item/custom_chainsaw" }
  ]
}

NBT contre Components

Minecraft 1.20.5 a remplacé l’ancienne syntaxe NBT des objets par les Data Components. Le résultat visuel est similaire, mais les commandes ont changé.

Avant 1.20.5

/give @p minecraft:iron_sword{CustomModelData:1} 1

1.20.5 et plus récent

/give @p minecraft:iron_sword[minecraft:custom_model_data=1] 1

Le générateur de packs de ressources Minecraft tient compte de ce changement quand il affiche les commandes give pour vos objets personnalisés.