Minecraft-CustomModelData-Guide: Was es ist und wie es funktioniert

Was ist CustomModelData?

CustomModelData wurde in Minecraft 1.14 hinzugefügt und erlaubt Pack-Erstellern, unterschiedliche Texturen oder 3D-Modelle über Zahlen-IDs an ein Vanilla-Item zu hängen.

• Ohne Tags sieht ein Eisenschwert wie das normale Vanilla-Schwert aus.
• Mit CustomModelData: 1 kann es wie ein Katana aussehen.
• Mit CustomModelData: 2 kann es als 3D-Kettensäge gerendert werden.

Für Server und Spielmechanik bleibt es ein Eisenschwert. Nur die visuelle Hülle auf Client-Seite ändert sich.

So funktioniert es

Das Resource-Pack nutzt Item-Modell-Overrides. Das Basismodell weist das Spiel an, ein anderes Modell zu laden, wenn ein bestimmter CustomModelData-Wert vorhanden ist.

{
  "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 vs Components

Minecraft 1.20.5 hat Item-Daten von alter NBT-Syntax auf Data Components umgestellt. Das visuelle Ergebnis ist ähnlich, aber Befehle haben sich geändert.

Vor 1.20.5

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

1.20.5 und neuer

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

Der Minecraft Resource-Pack-Generator berücksichtigt diese Umstellung, wenn er give-Befehle für deine Custom-Items zeigt.