Geprüft für die Versionen: Java Edition 1.20 bis 26.3.
Was sich wirklich geändert hat
Ein Item ist jetzt seine ID plus eine Liste von Komponenten. Jede Komponente hat eine feste Form, die das Spiel beim Lesen des Befehls prüft – ein Tippfehler, den NBT früher geschluckt hat, stoppt den Befehl jetzt. Der andere große Unterschied: Es gibt keine freien Schlüssel mehr. Ein selbst erfundenes Tag wie role:"guard" gehört in custom_data.
Dasselbe Item vor 1.20.5 und in 1.21.5 – 26.x:
/give @p minecraft:paper{display:{Name:'{"text":"Guild Pass","italic":false}'},CustomModelData:12,role:"guard"} 1
/give @p minecraft:paper[minecraft:custom_name={text:"Guild Pass",italic:false},minecraft:custom_model_data={floats:[12f]},minecraft:custom_data={role:"guard"}] 1
Altes Tag → Komponente
| Vor 1.20.5 | Ab 1.20.5 | Spätere Änderung |
|---|---|---|
display.Name | custom_name oder item_name | 1.21.5: als SNBT-Text, {text:"…"} |
display.Lore | lore | 1.21.5: jede Zeile als SNBT-Text |
CustomModelData:12 | custom_model_data | 1.21.4: {floats:[12f]}, dazu Listen für flags, strings und colors |
Enchantments | enchantments | 1.21.5: {"minecraft:sharpness":3} ohne die Hülle levels |
AttributeModifiers | attribute_modifiers | 1.21: id mit Namensraum; 1.21.2: ohne generic.; 1.21.5: eine einfache Liste |
Unbreakable:1b | unbreakable={} | |
HideFlags | Felder show_in_tooltip, hide_additional_tooltip | 1.21.5: tooltip_display={hidden_components:[…]} |
Eigene Tags, etwa role:"guard" | custom_data={role:"guard"} | Der einzige Ort für eigene Schlüssel |
display.color | dyed_color | 1.21.5: dyed_color=12345 statt {rgb:12345} |
Potion, CustomPotionEffects | potion_contents | |
SkullOwner | profile | |
BlockEntityTag, EntityTag | block_entity_data, entity_data |
Wenn eine Welt in einer neueren Version geöffnet wird, wandelt das Spiel die darin gespeicherten Items um. Befehle werden nicht umgewandelt: Befehlsblöcke, Funktionsdateien und gespeicherte Notizen behalten die alte Syntax, bis du sie neu schreibst.
Die zwei späteren Änderungen
1.21.4 hat geändert, wie Modelle gewählt werden. custom_model_data wurde zu vier typisierten Listen (floats, flags, strings, colors), und das Resource Pack wählt ein Modell über eine Item-Definition in assets/<namespace>/items/, auf die ein Item mit der Komponente item_model zeigt. Die alten overrides in Item-Modellen funktionieren nicht mehr.
1.21.5 hat geändert, wie Komponenten geschrieben werden. Textkomponenten sind SNBT statt JSON-Strings, mehrere Komponenten haben ihre Hülle verloren (enchantments, attribute_modifiers, dyed_color), und alle show_in_tooltip-Felder sind in eine einzige Komponente tooltip_display gewandert.
Warum custom_data für Server zählt
Ein sichtbarer Name ist am Amboss leicht gefälscht. Prüfen ein Laden, eine Tür oder eine Quest stattdessen einen versteckten Wert in custom_data, kommt ein umbenanntes Vanilla-Item nicht durch. Dorfbewohner-Handel vergleicht seit 1.20.5 die Komponenten, die im Preis stehen: Ein Handel, der custom_data={currency:"guild_voucher"} verlangt, nimmt nur den echten Schein an.
Einen Server umstellen, ohne etwas zu brechen
- Liste jede Stelle auf, an der Items entstehen: Befehlsblöcke, Funktionen, Beutetabellen, Dorfbewohner-Angebote, Plugin-Konfigurationen.
- Stell zuerst Namen, Lore und erfundene Tags (
custom_data) um, weil Läden und Quests sie lesen. - Wechselst du auf 1.21.4 oder neuer, schreib Modell-Hooks und Resource Pack gemeinsam um: Der Befehl füllt einen Slot, die Item-Definition liest ihn.
- Teste jedes Item einmal im Spiel, bevor es Spieler erreicht, und halt die Liste dort, wo das ganze Team sie sieht.
Häufige Fragen
custom_name oder item_name?
custom_name wirkt wie eine Amboss-Umbenennung und ist kursiv, außer du setzt italic:false. item_name ist der eigene Name des Items, nicht kursiv, und ein Amboss kann ihn nicht entfernen.
Kann ich einem Item noch eigene Daten geben?
Ja, in custom_data. Es nimmt jedes Compound an, und Befehle, Prädikate und Dorfbewohner-Handel können es prüfen.
Gibt es eine offizielle Liste der Komponenten?
Das Spiel zeigt sie in der Autovervollständigung von /give, und die Seite „Data component format“ im Minecraft Wiki beschreibt jede samt Änderungsverlauf.