Geprüft für die Versionen: Java Edition 1.20 bis 26.3.
Woraus ein Custom-Item besteht
| Schicht | Wo sie liegt | Wer sie liest |
|---|---|---|
| Basisitem | Die Item-ID, etwa minecraft:paper | Das Spiel: Stapelgröße, Animation, Haltbarkeit |
| Name und Lore | custom_name, lore | Spieler |
| Versteckte ID | custom_data={item_id:"…"} | Deine Befehle, Quests, Läden und Dorfbewohner |
| Modell-Hook | item_model, custom_model_data | Das Resource Pack |
Getrennte Schichten machen ein Item wartbar: Du kannst es für eine neue Saison umbenennen, ohne die Quest zu brechen, die seine versteckte ID prüft, und sein Aussehen ändern, ohne das eine oder das andere anzufassen.
Schritt für Schritt
- Befehlsversion. Wähl 1.21.5 – 26.x, 1.21.4, 1.20.5 – 1.21.3 oder vor 1.20.5. Das Formular zeigt nur die Felder, die diese Version kennt.
- Basisitem und Anzahl. Wähl die Basis nach dem Verhalten, nicht nur nach dem Aussehen: Papier stapelt bis 64, ein Buch öffnet sich nicht wie ein beschriebenes Buch, eine Karottenrute lässt sich benutzen.
- Versteckte ID. Eine stabile, langweilige ID wie
rp.guild.pass. Ab 1.20.5 kommt sie incustom_data; davor schreibt der Builder sie als eigenes NBT-Tag. - Name und Lore. Eine Lore-Zeile pro Zeile im Feld. Der Builder ergänzt
italic:false, damit der Name nicht wie eine Amboss-Umbenennung aussieht. - Modell. Vor 1.21.4 ist es eine CustomModelData-Zahl, auf die die
overridesdes Packs reagieren. Ab 1.21.4 nenntitem_modeleine Item-Definition:cubeinsquare:item/paper/guild_passliestassets/cubeinsquare/items/item/paper/guild_pass.json, und die Slots float, string, flag und color sind Werte, nach denen diese Datei umschalten kann. - Kopieren und testen. Die Übersicht zeigt die Länge: Über 256 Zeichen braucht der Befehl einen Befehlsblock statt des Chats.
Das Beispiel erklärt
„Beispiel laden“ füllt das Formular mit einem Gildenpass. Im Zweig 1.21.5 – 26.x entsteht:
/give @p minecraft:paper[minecraft:custom_name={text:"Guild archive pass",italic:false},minecraft:lore=[{text:"Stamped for the old city archive.",italic:false}],minecraft:item_model="cubeinsquare:item/paper/guild_pass",minecraft:custom_data={item_id:"rp.guild.pass"},minecraft:custom_model_data={floats:[2047.0f],strings:["guild_pass"],flags:[true],colors:[6138367]}] 1
custom_nameundloresind Textkomponenten in SNBT, die Form, die mit 1.21.5 kam.item_modelzeigt auf die Item-Definition im Pack.custom_dataträgt die versteckte ID, der der Server trauen kann.custom_model_dataträgt Werte, die die Item-Definition prüfen kann: einen Float fürrange_dispatch, einen String fürselect, ein Flag fürcondition, eine Farbe für Tönungen.
Derselbe Pass vor 1.20.5 ist ein einziger NBT-Block:
/give @p minecraft:paper{CustomModelData:2047,display:{Name:'{"text":"Guild archive pass","italic":false}',Lore:['{"text":"Stamped for the old city archive.","italic":false}']},cube_item_id:"rp.guild.pass"} 1
Die versteckte ID im Spiel prüfen
Ab 1.20.5 können Item-Prädikate custom_data direkt prüfen. Die erste Zeile reagiert auf jeden Spieler mit dem Pass in der Haupthand; die zweite nimmt einem Spieler einen Pass ab – so kann eine Tür oder ein Laden ihn „ausgeben“:
execute as @a if items entity @s weapon.mainhand *[custom_data~{item_id:"rp.guild.pass"}] run say I carry the guild pass
clear @s *[custom_data~{item_id:"rp.guild.pass"}] 1
Ein umbenanntes Vanilla-Papier fällt bei beiden Prüfungen durch, weil nicht der Name geprüft wird.
Häufige Fehler
- Die versteckte ID später ändern. Jede Quest, jeder Laden und jeder Handel, der sie prüft, erkennt alte Items nicht mehr. Ändere stattdessen den sichtbaren Namen.
- item_model zeigt auf ein Modell. Ab 1.21.4 nennt es eine Datei in
items/, die wiederum Modelle inmodels/nennt. Zeigt es direkt auf einen Modellpfad, erscheint die Textur für fehlende Modelle. - Ein Befehl für alle Versionen. Die vier Zweige gibt es, weil sich die Syntax wirklich unterscheidet: Ein Befehl für 1.21.4 nennt das Item in 1.21.5
{"text":…}.
Häufige Fragen
Brauche ich ein Resource Pack?
Nur für ein eigenes Aussehen. Name, Lore und versteckte ID funktionieren in Vanilla ohne Pack.
Wofür ist der Farb-Slot?
Eine Item-Definition kann eine Modellschicht mit Farben aus custom_model_data tönen, ein Modell bedient so mehrere Fraktionsfarben.
Kann ein Dorfbewohner nur das echte Item annehmen?
Ja: Leg dasselbe custom_data in den Preis des Handels. Der Handels-Builder und der Ökonomie-Artikel zeigen, wie.