Befehlsreferenz
Textkomponenten
Textkomponenten sind der formatierte Text, der von /tellraw, /title, Schildern, Gegenstandsnamen und Entitätsnamen verwendet wird. Eine Komponente ist eine Zeichenkette in Anführungszeichen, ein Objekt in geschweiften Klammern mit Inhalts- und Stilfeldern oder eine Liste von Komponenten.
Details
| Einfacher Text | Eine Zeichenkette in Anführungszeichen: „Hello“ oder 'Hello'. |
| Objekt | {text:"Hello",color:"red"}. Feldnamen können mit oder ohne Anführungszeichen geschrieben werden. |
| Liste | ["A",{text:"B"}]. Der erste Eintrag ist das übergeordnete Element; die anderen folgen ihm und übernehmen seine Formatierung. |
| Inhaltstypen | text, translatable, score, selector, keybind, nbt, object. Der Typ wird an den Feldern erkannt; ein Feld type ist optional. |
| Farbnamen | black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white. |
| Hex-Farben | # gefolgt von sechs Hexadezimalziffern, zum Beispiel #FF8800. |
| Vererbte Formatierung | Teile in extra übernehmen die Formatierung ihres übergeordneten Teils, sofern sie keine eigene festlegen. |
| Klickaktionen | open_url, run_command, suggest_command, show_dialog, change_page, copy_to_clipboard, custom. open_file wird in Befehlen abgelehnt. |
| Aktionen beim Darüberfahren | show_text, show_item, show_entity. |
| Zeilenumbruch | \n in Text in Anführungszeichen. |
Inhaltsfelder
| text | Zeigt den angegebenen Text | /tellraw @a {text:"Hello",color:"red"} |
| translate | Zeigt einen übersetzten Text anhand seines Schlüssels an | /tellraw @a {translate:"block.minecraft.stone"} |
| with | Werte, die in die Platzhalter eines übersetzten Textes eingesetzt werden | /tellraw @a {translate:"chat.type.announcement",with:["Server","Hello"]} |
| fallback | Text, der verwendet wird, wenn der Übersetzungsschlüssel unbekannt ist | /tellraw @a {translate:"my.custom.key",fallback:"Hi %s",with:[{selector:"@s"}]} |
| score | Zeigt einen Punktestand an. Braucht name (einen Namen oder Selektor) und objective | /tellraw @a ["Score: ",{score:{name:"@s",objective:"kills"},color:"gold"}] |
| selector | Zeigt die Namen der ausgewählten Entitäten | /tellraw @a {selector:"@a",separator:" and "} |
| separator | Text, der zwischen mehrere Namen oder Werte gesetzt wird | /tellraw @a {selector:"@a",separator:{text:" | ",color:"gray"}} |
| keybind | Zeigt die Taste, die der Leser für eine Steuerung festgelegt hat | /tellraw @a {keybind:"key.jump"} |
| nbt | Zeigt einen aus Daten gelesenen Wert anhand eines Datenpfads an | /tellraw @a {nbt:"Health",entity:"@s"} |
| entity | Liest den Wert nbt aus den gewählten Objekten | /tellraw @a {nbt:"Pos",entity:"@s",plain:true,separator:", "} |
| block | Liest den Wert nbt aus dem Block an einer Position | /tellraw @a {nbt:"Items[0].id",block:"~ ~-1 ~"} |
| storage | Liest den Wert nbt aus dem Befehlsspeicher | /tellraw @a {nbt:"message",storage:"my_pack:data",interpret:true} |
| interpret | Behandelt den nbt-Wert als Textkomponente. Nicht kombinierbar mit plain | /tellraw @a {nbt:"message",storage:"my_pack:data",interpret:true} |
| plain | Zeigt den NBT-Wert ohne Färbung. Nicht kombinierbar mit interpret | /tellraw @a {nbt:"Pos",entity:"@s",plain:true,separator:", "} |
| sprite | Zeigt ein Bild aus einem Texturatlas an | /tellraw @a {sprite:"minecraft:block/diamond_block"} |
| atlas | Atlas, aus dem das Sprite stammt. Standard ist minecraft:blocks | /tellraw @a {atlas:"minecraft:items",sprite:"minecraft:item/diamond"} |
| player | Zeigt den Kopf eines Spielerskins | /tellraw @a {player:{name:"Notch"},hat:false} |
| hat | Ob die Hutebene des Kopfes dargestellt wird. Standard ist true | /tellraw @a {player:{name:"Notch"},hat:false} |
| type | Nennt den Inhaltstyp direkt: text, translatable, score, selector, keybind, nbt oder object | /tellraw @a {type:"text",text:"Typed"} |
| extra | Weitere Komponenten, die direkt nach dieser angezeigt werden | /tellraw @a {text:"A",color:"red",extra:[{text:"B",bold:true},"C"]} |
Stilfelder
| color | Textfarbe, ein Farbname oder #RRGGBB | /tellraw @a {text:"Hello",color:"#FF8800"} |
| shadow_color | Farbe des Textschattens, eine Zahl oder [red,green,blue,alpha] von 0 bis 1 | /tellraw @a {text:"Hello",shadow_color:[1.0f,0.0f,0.0f,1.0f]} |
| bold | Fetter Text, true oder false | /tellraw @a {text:"A",color:"red",extra:[{text:"B",bold:true},"C"]} |
| italic | Kursiver Text, true oder false | /title @a subtitle {text:"Good luck",italic:true} |
| underlined | Unterstrichener Text, true oder false | /tellraw @a {text:"Hello",color:"#FF8800",bold:true,italic:true,underlined:true,strikethrough:true,obfuscated:false} |
| strikethrough | Durchgestrichener Text, true oder false | /tellraw @a {text:"Hello",color:"#FF8800",bold:true,italic:true,underlined:true,strikethrough:true,obfuscated:false} |
| obfuscated | Durcheinandergewürfelte, sich ständig ändernde Buchstaben, true oder false | /tellraw @a {text:"Hello",color:"#FF8800",bold:true,italic:true,underlined:true,strikethrough:true,obfuscated:false} |
| font | ID der Schriftart, mit der gezeichnet wird | /tellraw @a {text:"Hello",font:"minecraft:alt"} |
| insertion | Text, der beim Umschalt-Klick auf den Text in das Chatfeld eingefügt wird | /tellraw @a {text:"Shift-click me",insertion:"inserted text"} |
| click_event | Was passiert, wenn auf den Text geklickt wird | /tellraw @a {text:"Click",click_event:{action:"run_command",command:"/say hi"}} |
| hover_event | Was angezeigt wird, wenn der Zeiger auf dem Text ruht | /tellraw @a {text:"Hover",hover_event:{action:"show_text",value:"Tooltip"}} |
Klickaktionen
| run_command | command | Führt den Befehl als der Spieler aus, der klickt | /tellraw @a {text:"Click",click_event:{action:"run_command",command:"/say hi"}} |
| suggest_command | command | Fügt den Text in das Chatfeld ein | /tellraw @a {text:"Click",click_event:{action:"suggest_command",command:"/tp @s 0 64 0"}} |
| open_url | url | Öffnet eine Webadresse | /tellraw @a {text:"Click",click_event:{action:"open_url",url:"https://www.minecraft.net"}} |
| copy_to_clipboard | value | Kopiert den Text in die Zwischenablage | /tellraw @a {text:"Click",click_event:{action:"copy_to_clipboard",value:"copied text"}} |
| change_page | page | Blättert zu einer Seite in einem Buch, 1 oder höher | /tellraw @a {text:"Click",click_event:{action:"change_page",page:2}} |
| show_dialog | dialog | Öffnet einen Dialog, per ID oder ausgeschrieben | /tellraw @a {text:"Click",click_event:{action:"show_dialog",dialog:"minecraft:server_links"}} |
| custom | id, payload (optional) | Sendet ein benutzerdefiniertes Ereignis an den Server | /tellraw @a {text:"Click",click_event:{action:"custom",id:"my_pack:event",payload:{a:1}}} |
Aktionen beim Darüberfahren
| show_text | value | Eine Textkomponente als Tooltip | /tellraw @a {text:"Hover",hover_event:{action:"show_text",value:{text:"Tooltip",color:"yellow"}}} |
| show_item | id, count (optional), components (optional) | Der Tooltip eines Gegenstands | /tellraw @a {text:"Hover",hover_event:{action:"show_item",id:"minecraft:diamond_sword",count:1,components:{"minecraft:damage":5}}} |
| show_entity | id, uuid, name (optional) | Typ, Name und UUID einer Entität | /tellraw @a {text:"Hover",hover_event:{action:"show_entity",id:"minecraft:pig",uuid:"dd12be42-52a9-4a91-a8a1-11c01849e498",name:"Porky"}} |
Wo Textkomponenten verwendet werden
| Chatnachricht | /tellraw @a "Hello" |
| Titel | /title @a title {text:"Welcome",color:"gold",bold:true} |
| Aktionsleiste | /title @a actionbar {text:"Low health",color:"red"} |
| Schild-Text | /setblock ~ ~ ~ minecraft:oak_sign{front_text:{messages:["Line 1",{text:"Line 2",color:"red"},"",""]}} |
| Objektname | /summon minecraft:zombie ~ ~ ~ {CustomName:{text:"Boss",color:"dark_red"},CustomNameVisible:1b} |
| Gegenstandsname | /give @s minecraft:stick[custom_name={text:"Magic Wand",color:"gold",italic:false}] |
| Name der Bossleiste | /bossbar add my_pack:boss {text:"Boss",color:"red"} |
| Zielname | /scoreboard objectives add kills minecraft.killed:minecraft.zombie {text:"Zombie Kills",color:"green"} |
Beispiele
/tellraw @a {text:"Hello",color:"red"}Sendet ein rotes Hello an alle Spieler.
/tellraw @a ["",{text:"A",color:"red"},{text:"B",color:"blue"}]Sendet ein rotes A, gefolgt von einem blauen B. Der leere erste Eintrag hält die Farben auseinander.
/tellraw @a {text:"Click",click_event:{action:"suggest_command",command:"/tp @s 0 64 0"}}Sendet Text, der beim Anklicken das Chatfeld mit einem Teleport-Befehl füllt.
/tellraw @a ["Score: ",{score:{name:"@s",objective:"kills"},color:"gold"}]Zeigt den Wert von „kills“ für den, der den Befehl ausführt.
/tellraw @a {text:"Hover",hover_event:{action:"show_item",id:"minecraft:diamond_sword",count:1,components:{"minecraft:damage":5}}}Sendet Text, der ein Diamantschwert-Tooltip anzeigt, wenn der Zeiger darauf ruht.
/title @a title {text:"Welcome",color:"gold",bold:true}Zeigt jedem Spieler einen fetten goldenen Titel an.
/title @a subtitle {text:"Good luck",italic:true}Legt den Untertitel fest, der unter dem nächsten Titel angezeigt wird.
/title @a actionbar {text:"Low health",color:"red"}Zeigt roten Text über der Schnellzugriffsleiste.
/title @a times 0.5s 3s 1sStellt Titel so ein, dass sie eine halbe Sekunde einblenden, 3 Sekunden bleiben und 1 Sekunde ausblenden.