Befehlsreferenz
Gegenstandskomponenten
Gegenstände in Befehlen werden als ID geschrieben, gefolgt von Komponenten in eckigen Klammern. Komponenten enthalten alles Besondere an einem Gegenstand, etwa Name, Verzauberungen und Haltbarkeit.
Details
| Gegenstandssyntax | id[component=value,component=value]. Der Teil minecraft: von IDs und Komponentennamen darf weggelassen werden. |
| Eine Komponente entfernen | Ein ! vor dem Namen ohne Wert entfernt die Komponente, zum Beispiel minecraft:diamond_sword[!attribute_modifiers]. |
| Wiederholen | Jede Komponente darf pro Gegenstand nur einmal vorkommen. |
| Werte | Im Datenformat geschrieben: Zahlen, Text in Anführungszeichen, Listen in [ ] und benannte Werte in { }. |
| Komponententypen | 119, die in Befehlen verwendet werden können. |
| Gegenstandstests | Verwendet von /clear und /execute if items. Beginne mit einer Gegenstands-ID, einer Gegenstandsgruppe mit # oder * für jeden Gegenstand, dann optionale Tests in [ ]. |
| Tests kombinieren | Ein Komma bedeutet, dass beide Tests bestanden werden müssen, | bedeutet, dass einer genügt, und ! vor einem Test kehrt ihn um. |
| Exakter Test | component=value trifft zu, wenn der Gegenstand genau diesen Wert hat. |
| Teiltest | name~value prüft einen Teil einer Komponente. Verfügbar für attribute_modifiers, bundle_contents, container, custom_data, damage, enchantments, firework_explosion, fireworks, jukebox_playable, potion_contents, stored_enchantments, trim, villager/variant, writable_book_content und written_book_content. |
| Anzahltest | count=5 für eine genaue Stapelgröße oder count~{min:..,max:..} für einen Bereich. |
| Wo Daten in geschweiften Klammern weiterhin gelten | Objekt- und Blockdaten: /summon, /data, das nbt-Selektorargument und Blockdaten nach einer Block-ID. |
Allgemeine Komponenten
| enchantments | Verzauberungen auf dem Gegenstand mit ihren Stufen | /give @s minecraft:diamond_sword[enchantments={sharpness:5,unbreaking:3}] |
| stored_enchantments | Verzauberungen eines verzauberten Buchs | /give @s minecraft:enchanted_book[stored_enchantments={mending:1}] |
| custom_name | Für den Gegenstand angezeigter Name, als Textkomponente | /give @s minecraft:stick[custom_name={text:"Magic Wand",color:"gold",italic:false}] |
| item_name | Basisname des Gegenstands als Textkomponente | /give @s minecraft:stick[item_name="Wand"] |
| lore | Zusätzliche Tooltip-Zeilen, eine Liste von Textkomponenten | /give @s minecraft:stick[lore=["First line",{text:"Second line",color:"gray"}]] |
| damage | Bereits aufgebrauchte Haltbarkeit | /give @s minecraft:diamond_pickaxe[damage=100] |
| max_damage | Gesamthaltbarkeit | /give @s minecraft:diamond_pickaxe[max_damage=5000] |
| unbreakable | Gegenstand verliert nie Haltbarkeit | /give @s minecraft:diamond_pickaxe[unbreakable={}] |
| max_stack_size | Größter Stapel, 1 bis 99 | /give @s minecraft:ender_pearl[max_stack_size=64] |
| attribute_modifiers | Attributänderungen, solange der Gegenstand in einem Slot liegt | /give @s minecraft:stick[attribute_modifiers=[{type:"minecraft:attack_damage",amount:10,id:"example:bonus",operation:"add_value",slot:"mainhand"}]] |
| potion_contents | Typ, Farbe und eigene Effekte: Trank | /give @s minecraft:potion[potion_contents={custom_color:16711680,custom_effects:[{id:"minecraft:speed",amplifier:1,duration:600}]}] |
| dyed_color | Farbstofffarbe als eine Zahl oder als [red,green,blue] von 0 bis 1 | /give @s minecraft:leather_chestplate[dyed_color=16711680] |
| fireworks | Flugdauer und Explosionen einer Rakete | /give @s minecraft:firework_rocket[fireworks={flight_duration:2,explosions:[{shape:"large_ball",colors:[I;16711680],fade_colors:[I;255],has_trail:true,has_twinkle:true}]}] |
| firework_explosion | Explosion eines Feuerwerkssterns | /give @s minecraft:firework_star[firework_explosion={shape:"star",colors:[I;65280]}] |
| written_book_content | Titel, Autor und Seiten eines beschriebenen Buchs | /give @s minecraft:written_book[written_book_content={title:"Guide",author:"Steve",pages:["Page one",{text:"Page two",bold:true}]}] |
| writable_book_content | Seiten eines Buches mit Feder | /give @s minecraft:writable_book[writable_book_content={pages:["Notes"]}] |
| food | Hunger und Sättigung beim Essen wiederhergestellt | /give @s minecraft:stick[food={nutrition:4,saturation:2.4,can_always_eat:true},consumable={}] |
| consumable | Macht den Gegenstand durch Essen oder Trinken nutzbar | /give @s minecraft:stick[consumable={consume_seconds:0.8,animation:"eat"}] |
| tooltip_display | Verbirgt den Tooltip oder einzelne Komponenten darin | /give @s minecraft:diamond_sword[enchantments={sharpness:5},tooltip_display={hidden_components:["minecraft:enchantments"]}] |
| enchantment_glint_override | Erzwingt den Verzauberungsglanz ein oder aus | /give @s minecraft:stick[enchantment_glint_override=true] |
| rarity | Namensfarbklasse: common, uncommon, rare oder epic | /give @s minecraft:stick[rarity="epic"] |
| custom_data | Freie Daten für Datenpakete | /give @s minecraft:stick[custom_data={quest_item:1b}] |
| custom_model_data | Werte, mit denen Ressourcenpakete ein Modell auswählen | /give @s minecraft:stick[custom_model_data={floats:[1.0f],strings:["wand"]}] |
| item_model | Modell, mit dem der Gegenstand gezeichnet wird | /give @s minecraft:stick[item_model="minecraft:blaze_rod"] |
| can_break | Blöcke, die der Gegenstand im Modus Abenteuer abbauen kann | /give @s minecraft:diamond_pickaxe[can_break={blocks:"#minecraft:logs"}] |
| can_place_on | Blöcke, auf denen der Gegenstand im Modus Abenteuer platziert werden kann | /give @s minecraft:stone[can_place_on={blocks:"minecraft:grass_block"}] |
| container | In einem Behältergegenstand gespeicherte Gegenstände | /give @s minecraft:chest[container=[{slot:0,item:{id:"minecraft:diamond",count:3}}]] |
| bundle_contents | Gegenstände in einem Bündel | /give @s minecraft:bundle[bundle_contents=[{id:"minecraft:arrow",count:16}]] |
| profile | Skin, den ein Spielerkopf zeigt: Spieler | /give @s minecraft:player_head[profile={name:"Notch"}] |
| trim | Material und Muster: Rüstung | /give @s minecraft:iron_chestplate[trim={material:"minecraft:gold",pattern:"minecraft:coast"}] |
| equippable | Erlaubt, den Gegenstand in einem Slot zu tragen | /give @s minecraft:stick[equippable={slot:"head"}] |
| use_cooldown | Wartezeit in Sekunden nach der Benutzung | /give @s minecraft:ender_pearl[use_cooldown={seconds:5}] |
| repair_cost | Zusätzliche Amboss-Kosten in Stufen | /give @s minecraft:diamond_sword[repair_cost=10] |
| block_entity_data | Blockdaten, die beim Platzieren des Blocks angewendet werden | /give @s minecraft:spawner[block_entity_data={id:"minecraft:mob_spawner",Delay:20s}] |
| entity_data | Objektdaten, die angewendet werden, wenn der Gegenstand ein Objekt erzeugt | /give @s minecraft:armor_stand[entity_data={id:"minecraft:armor_stand",Small:1b}] |
Gegenstandstests
| id | Dieser Gegenstand | /clear @s minecraft:diamond |
| #tag | Beliebiger Gegenstand im Tag | /clear @s #minecraft:planks |
| * | Beliebiger Gegenstand | /clear @s * |
| [component] | Gegenstände mit der Komponente | /clear @s *[damage] |
| [!component] | Gegenstände ohne die Komponente | /clear @s *[!damage] |
| [component=value] | Gegenstände, deren Komponente genau dem Wert entspricht | /clear @s minecraft:diamond_sword[damage=0] |
| [name~value] | Gegenstände, die einen Teiltest bestehen | /clear @s *[enchantments~[{enchantments:"minecraft:sharpness",levels:{min:3}}]] |
| [count=n] | Stapel genau dieser Größe | /clear @s minecraft:stick[count=5] |
| [count~{min:n}] | Stapel in einem Größenbereich | /clear @s *[count~{min:32}] |
| [a|b] | Gegenstände, die einen der beiden Tests bestehen | /clear @s *[damage|unbreakable] |
| [a,b] | Gegenstände, die beide Tests bestehen | /clear @s #minecraft:swords[enchantments~[{}],!custom_name] |
Datenwerttypen
| Byte | Ganzzahl mit b | 1b |
| Kurz | Ganzzahl mit s | 20s |
| Ganzzahl | Ganzzahl oder mit i | 5 |
| Long | Ganzzahl mit L | 4L |
| Gleitkommazahl | Zahl mit f | 5.5f |
| Gleitkommazahl (Double) | Zahl mit Dezimalpunkt oder mit d | 6.5d |
| Wahr oder falsch | true oder false, gespeichert als 1b oder 0b | true |
| Text | In doppelten oder einfachen Anführungszeichen. Einfache Wörter brauchen keine Anführungszeichen | „Steve“ |
| Liste | Werte in [ ], durch Kommas getrennt | [1,2,3] |
| Benannte Werte | key:value-Paare in { } | {id:"minecraft:diamond",count:3} |
| Byte-Liste | [B; ...] | [B;1b,2b] |
| Ganzzahlliste | [I; ...] | [I;1,2] |
| Long-Liste | [L; ...] | [L;1L,2L] |
| Hex- oder Binärzahl | 0x oder 0b davor | 0x1F |
| Unsigniert oder signiert | u oder s vor dem Typbuchstaben | 255ub |
| Zifferngruppierung | Unterstriche zwischen Ziffern | 1_000 |
| bool(...) | Wandelt eine Zahl in wahr oder falsch um | bool(1) |
| uuid(...) | Wandelt einen UUID-Text in seine gespeicherte Form um | uuid("dd12be42-52a9-4a91-a8a1-11c01849e498") |
Wo Daten in geschweiften Klammern verwendet werden
| Objektdaten beim Beschwören | /summon minecraft:pig ~ ~ ~ {NoAI:1b} |
| Entitätsdaten ändern | /data merge entity @n[type=minecraft:zombie] {NoAI:1b,CustomName:"Bob"} |
| Lesen mit einem Datenpfad | /data get entity @s Inventory[{id:"minecraft:diamond"}].count |
| Komponente innerhalb eines Datenpfads | /data get entity @s SelectedItem.components."minecraft:damage" |
| Blockdaten | /data get block ~ ~ ~ Items[0] |
| Befehlsspeicher | /data modify storage my_pack:data name set value "Steve" |
| Selektor-Filter | /kill @e[type=minecraft:zombie,nbt={NoAI:1b}] |
Beispiele
/give @s minecraft:diamond_sword[custom_name={text:"Excalibur",color:"gold",italic:false},enchantments={sharpness:5},unbreakable={}]Gibt ein unzerbrechliches Schwert mit Schärfe V und goldenem Namen.
/give @s minecraft:diamond_sword[!attribute_modifiers]Gibt ein Diamantschwert ohne seine Boni für Angriffsschaden und Angriffstempo.
/give @s minecraft:potion[potion_contents={potion:"minecraft:strong_healing"}]Gibt: Trank der Heilung II.
/item replace entity @s weapon.mainhand with minecraft:diamond_sword[enchantments={sharpness:5}]Legt ein Diamantschwert mit Schärfe V in deine Haupthand.
/clear @s *[damage~{durability:{max:10}}]Entfernt jeden Gegenstand mit höchstens 10 verbleibender Haltbarkeit.
/execute if items entity @s weapon.mainhand minecraft:diamond_sword run say yesGibt yes aus, wenn du ein Diamantschwert hältst.
/execute if items entity @s container.* *[custom_data~{key:1b}] run say yesGibt yes aus, wenn irgendein Inventarplatz einen Gegenstand enthält, dessen benutzerdefinierte Daten key auf 1b gesetzt haben.
/data merge storage my_pack:data {a:1,b:2b,c:3s,d:4L,e:5.5f,f:6.5d,g:"text",h:[1,2,3],i:[B;1b,2b],j:[I;1,2],k:[L;1L,2L],l:{m:true}}Speichert einen Wert jedes Datentyps.