Befehl
/scoreboard
Erstellt und verwaltet Scoreboard-Ziele, legt fest, wo sie angezeigt werden, und liest oder ändert die Punktestände von Spielern und anderen Entitäten.
Syntax
| /scoreboard objectives add <objective> <criteria> [<displayName>] |
| /scoreboard objectives list |
| /scoreboard objectives modify <objective> (displayautoupdate <value>|displayname <displayName>) |
| /scoreboard objectives modify <objective> numberformat |
| /scoreboard objectives modify <objective> numberformat blank |
| /scoreboard objectives modify <objective> numberformat (fixed <contents>|styled <style>) |
| /scoreboard objectives modify <objective> rendertype (hearts|integer) |
| /scoreboard objectives remove <objective> |
| /scoreboard objectives setdisplay <slot> [<objective>] |
| /scoreboard players (add <targets>|remove <targets>) <objective> <score> |
| /scoreboard players display name <targets> <objective> [<name>] |
| /scoreboard players display numberformat <targets> <objective> |
| /scoreboard players display numberformat <targets> <objective> blank |
| /scoreboard players display numberformat <targets> <objective> (fixed <contents>|styled <style>) |
| /scoreboard players (enable <targets>|get <target>) <objective> |
| /scoreboard players list [<target>] |
| /scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective> |
| /scoreboard players reset <targets> [<objective>] |
| /scoreboard players set <targets> <objective> <score> |
Argumente
| Argument | Wertart | Einzugeben |
|---|---|---|
| <objective> | Text | Der Name des Ziels. Bei objectives add ist es der neue Name, ein Wort ohne Leerzeichen. Überall sonst muss es ein vorhandenes Ziel sein. |
| <criteria> | Zielkriterium | Was das Ziel zählt: dummy, trigger, deathCount, playerKillCount, totalKillCount, health, food, air, armor, xp, level, teamkill.<color>, killedByTeam.<color> oder eine Statistik wie minecraft.custom:minecraft.jump. |
| <displayName> | Textkomponente | Der für das Ziel angezeigte Name, als Textkomponente geschrieben, etwa "Kills" oder {text:"Kills",color:"red"}. |
| <value> | Wahr oder falsch | true oder false für displayautoupdate. |
| <contents> | Textkomponente | Die Textkomponente, die bei numberformat fixed anstelle der Zahl angezeigt wird. |
| <style> | Textstil | Der Textstil für die Zahl bei numberformat styled, zum Beispiel {color:"gold"}. |
| <slot> | Anzeige-Slot | Der Anzeigeplatz: list, sidebar, below_name oder sidebar.team.<color>. |
| <targets> | Punkteinhaber | Die Punkteinhaber, die geändert werden: ein Zielselektor, ein Name oder * für alle erfassten Punkteinhaber. |
| <score> | Ganzzahl | Die Zahl, die gesetzt wird (jede ganze Zahl), oder die Menge, die hinzugefügt oder entfernt wird (0 oder mehr). Mindestens 0. |
| <name> | Textkomponente | Die Textkomponente, die bei players display name anstelle des Namens des Punkteinhabers angezeigt wird. |
| <target> | Punkteinhaber | Ein einzelner Punktehalter für players get und players list. |
| <targetObjective> | Scoreboard-Ziel | Das Ziel, dessen Punktzahl durch die Operation players geändert wird. Darf nicht schreibgeschützt sein. |
| <operation> | Punktestand-Operation | Eines von =, +=, -=, *=, /=, %=, <, >, ><. |
| <source> | Punkteinhaber | Die Punkteinhaber, deren Punktestände bei players operation als zweiter Wert verwendet werden. |
| <sourceObjective> | Scoreboard-Ziel | Das Ziel, aus dem die Quellpunktzahlen gelesen werden. |
Details
| Berechtigungsstufe | 2: Operatoren, Welten mit aktivierten Cheats, Befehlsblöcke und Funktionen |
| Funktioniert in | Einzelspieler mit aktivierten Cheats, Mehrspielerserver, Befehlsblöcke und Funktionen. Erfordert Berechtigungsstufe 2 (Spielleiter): Operatoren, Spieler in einer Welt mit aktivierten Cheats, Befehlsblöcke und Funktionen. |
| Ergebnis | Jeder Unterbefehl meldet, was er geändert hat. Numerische Ergebnisse: objectives add und objectives remove liefern die Anzahl der nun vorhandenen Ziele; objectives list liefert die Anzahl der Ziele; objectives setdisplay und objectives modify liefern 0. players get liefert den Punktestand; players set, add, remove und operation liefern die Summe der neuen Punktestände aller Ziele; players reset und players display liefern die Anzahl der Ziele; players enable liefert die Anzahl der Ziele, deren Trigger neu aktiviert wurde; players list liefert die Anzahl der erfassten Punkteinhaber, mit einem Ziel die Anzahl seiner Punktestände. |
| objectives add | Erstellt ein Ziel mit einem Namen, einem Kriterium und einem optionalen Anzeigenamen. Der Name ist ein einzelnes Wort ohne Leerzeichen. Ohne Anzeigenamen wird der Name selbst angezeigt. Schlägt mit „Ein Punkte‐Ziel mit diesem Namen existiert bereits“ fehl, wenn der Name schon vergeben ist. |
| Kriterien | Grundlegende Kriterien: dummy (nur durch Befehle geändert), trigger (Spieler ändern es selbst mit /trigger), deathCount, playerKillCount, totalKillCount, health, food, air, armor, xp, level. Teamkriterien: teamkill.<color> und killedByTeam.<color> mit einer Teamfarbe wie red oder dark_blue. Statistikkriterien haben die Form minecraft.<type>:minecraft.<id> mit den Typen broken, crafted, custom, dropped, killed, killed_by, mined, picked_up und used, zum Beispiel minecraft.mined:minecraft.stone oder minecraft.custom:minecraft.jump. |
| Nur lesbare Kriterien | health, food, air, armor, xp und level werden vom Spiel auf dem aktuellen Stand gehalten. Ihre Punktestände können nicht mit players set, add, remove oder als Ziel von operation geändert werden: „Scoreboard objective ... is read-only“. |
| objectives list und remove | objectives list zeigt alle Ziele. objectives remove löscht ein Ziel samt allen seinen Punktständen. |
| objectives setdisplay | Zeigt ein Ziel in einem Anzeigeplatz. Plätze: list (die Spielerliste), sidebar (die rechte Bildschirmseite), below_name (unter den Namensschildern der Spieler) und sidebar.team.<color> für eine an eine Teamfarbe gebundene Seitenleiste, mit den Farben black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow und white. Wird das Ziel weggelassen, wird der Slot geleert. Schlägt fehl, wenn der Platz bereits leer ist oder dieses Ziel bereits anzeigt. |
| objectives modify | displayname ändert den angezeigten Namen. rendertype wechselt zwischen integer (Zahlen) und hearts (Herzsymbole); health verwendet standardmäßig hearts, alle anderen integer. numberformat legt das Standardaussehen aller Punktestände im Ziel fest. displayautoupdate true oder false schaltet die automatische Aktualisierung der Anzeige des Ziels ein oder aus. |
| Zahlenformate | blank blendet die Zahl aus. fixed <contents> zeigt einen festen Text statt der Zahl. styled <style> zeigt die Zahl mit einem Textstil wie {color:"gold",bold:true}. numberformat ohne Angabe dahinter entfernt das Format wieder. Die gleichen Optionen gibt es für ein ganzes Ziel (objectives modify ... numberformat) und für einzelne Punkteinhaber (players display numberformat). |
| players set, add, remove | set gibt einem Punktestand eine beliebige ganze Zahl von -2147483648 bis 2147483647. add und remove nehmen einen Betrag von 0 oder mehr und ändern den aktuellen Punktestand um diesen Wert. Ein Ziel ohne Punktestand beginnt bei 0. |
| players get und list | get zeigt den Punktestand eines Ziels und schlägt mit „Can't get value of ... for ...; none is set“ fehl, wenn keiner gesetzt ist. list ohne Ziel zeigt alle verfolgten Namen; mit einem Ziel zeigt es alle Punktestände dieses Ziels. |
| players reset | Entfernt den Punktestand der Ziele in einem Ziel oder alle ihre Punktestände, wenn kein Ziel angegeben ist. Ein zurückgesetzter Punktestand ist überhaupt nicht mehr gesetzt, was etwas anderes ist als 0. |
| players enable | Erlaubt den Zielen, /trigger einmal für ein Ziel mit dem Kriterium trigger zu nutzen. Schlägt bei anderen Zielen mit „Dieser Befehl funktioniert nur für Auslöser (trigger‐Punkte‐Ziele)“ fehl und mit „Nichts geändert. Dieser Trigger ist bereits aktiviert“, wenn kein Ziel geändert wurde. |
| players operation | Ändert den Zielpunktestand anhand eines Quellpunktestands. Zeichen: = setzt das Ziel auf die Quelle, += addiert, -= subtrahiert, *= multipliziert, /= dividiert (abgerundet), %= ergibt den Rest der Division (bei positivem Divisor nie negativ), < behält den kleineren der beiden Werte, > den größeren, >< tauscht die beiden Punktestände. Eine Division durch 0 schlägt mit „Durch Null kann nicht geteilt werden“ fehl. Bei mehreren Quellen wird die Operation einmal für jede Quelle angewendet. |
| players display | display name gibt einem Punkteinhaber in der Punkteanzeige für ein Ziel einen anderen Namen; ohne Namen wird er entfernt. display numberformat ändert, wie die Zahl dieses Inhabers in diesem Ziel aussieht. |
| Punkteinhaber | Ziele können Zielselektoren, Spielernamen oder beliebige erfundene Namen wie #total sein. * steht für jeden erfassten Punkteinhaber. Ein Selektor, der nichts findet, schlägt mit „Es wurden keine relevanten Punktehalter gefunden“ fehl. |
Beispiele
/scoreboard objectives add kills playerKillCount "Kills"Erstellt ein Ziel namens kills, das Spielerkills zählt und als Kills angezeigt wird.
/scoreboard objectives add points dummyErstellt ein Ziel namens points, das sich nur durch Befehle ändert.
/scoreboard objectives setdisplay sidebar killsZeigt das Ziel „kills“ auf der rechten Bildschirmseite.
/scoreboard players set @s points 10Setzt deinen Punktestand für points auf 10.
/scoreboard players add @a points 1Fügt jedem Online-Spieler 1 Punkt hinzu.
/scoreboard players operation @s points += @s killsAddiert deinen kills-Punktestand zu deinem points-Punktestand.
/scoreboard objectives modify points numberformat styled {color:"gold"}Zeigt alle Zahlen des Punkteziels in Gold.
/scoreboard players reset @a pointsEntfernt den Punktestand jedes Spielers, der online ist.
