Das offizielle Minecraft Wiki twittert hier: Wiki-Twitter   Noch keinen Server gefunden? Es gibt einen Wiki-Server

Befehl

Aus Minecraft Wiki
(Weitergeleitet von Befehle)
Wechseln zu: Navigation, Suche

Mit einem Befehl können Veränderungen am Spielgeschehen außerhalb des eigentlichen Spiels hervorgerufen werden. Daher sind nicht immer alle Befehle für jeden Spieler zugänglich.

Nutzbarkeit[Bearbeiten | Quelltext bearbeiten]

Es gibt vier Gruppen von Befehlen:

  • Spieler-Befehl: Diesen Befehl kann jeder Spieler ohne Einschränkung ausführen, d.h. im Einzelspielermodus mit der Option "Cheats erlauben: Aus" und im Mehrspielermodus ohne Operator zu sein.
  • Cheat-Befehl: Dieser Befehl kann das Spiel verändern und wird daher Cheat (engl. für Mogelei) genannt. Um ihn benutzen zu können, muss man im Einzelspieler-Modus vor der Weltgenerierung die Option "Cheats erlauben" einschalten bzw. bei der Veröffentlichung im LAN einstellen. Im Mehrspieler-Modus muss man Op-Rechte haben. Im Mehrspieler-Modus werden automatisch alle Spieler über einen eingegebenen Operator-Befehl informiert.
  • Server-Befehl: Dieser Befehl ist auf Servern vorhanden, d. h. man kann ihn in der Server-Konsole eintippen. Ebenso kann man ihn im Client eingeben, wenn man im Mehrspielermodus mit einem Server verbunden ist und OP-Rechte besitzt. Einige dieser Befehle gibt es nicht im Einzelspieler-Modus. Zum Einzelspieler-Modus zählt auch die Veröffentlichung einer Welt im LAN ("LAN-Welt"), da dies kein Serverbetrieb ist.
  • Befehlsblock-Befehl: Dieser Befehl kann vom Befehlsblock oder der Befehlsblocklore verwendet werden.

Ausführen[Bearbeiten | Quelltext bearbeiten]

Ein Befehl kann auf mehrere Arten ausgeführt werden:

  • Durch direkte Eingabe in der Chat-Konsole. Um den Befehl von einem Chat-Text zu unterscheiden, muss er mit einem führenden Schrägstrich / gekennzeichnet werden. Um die Chat-Konsole zu öffnen, drückt man entweder die Chattaste T oder die Befehlstaste # (bei englischen Tastaturen liegt auf dieser Taste der Schrägstrich), die den benötigten Schrägstrich gleich vorgibt.
  • Durch direkte Eingabe in der Server-Konsole. Dort kann ein Befehl ohne vorangestellten Schrägstrich eingegeben werden, weil ein direktes Chatten in der Server-Konsole nicht möglich ist (nur über Befehle).
  • Durch Hinterlegung in einem Befehlsblock. Sobald dieser durch ein Redstone-Signal aktiviert wird, wird der Befehl ausgeführt.
  • Durch Hinterlegung in einer Befehlsblocklore. Dadurch wird der Befehl mobil und kann mit der Lore an einen beliebigen Ort gefahren werden, der mit dem Schienennetz verbunden ist.
  • Durch Verwendung eines JSON-Textes im Befehl /tellraw. Damit kann eine Nachricht über den Chat gesendet werden, die einen oder mehrere anklickbare Textteile enthält, die jeweils einen Befehl ausführen.
  • Durch Verwendung eines JSON-Textes in einem Schild. Wenn der JSON-Text anklickbare Textteile enthält, wird dadurch das Schild anklickbar und löst dann alle Befehle aus.
  • Durch Verwendung eines JSON-Textes in einem beschriebenen Buch. Dadurch ist der Befehl mobil und kann überall hin getragen werden. Durch Anklicken eines Textteils im Buch wird der Befehl ausgelöst.

Wenn ein Befehl einen Block oder ein Objekt in der Welt verändert, muss der Block bzw. das Objekt geladen sein, sonst wird eine Fehlermeldung ausgegeben.

Übersicht[Bearbeiten | Quelltext bearbeiten]

Hilfsmittel
Befehl Beschreibung
/? Identisch mit /help.
/debug Startet oder stoppt das Schreiben eines Debug-Protokolls.
/help Listet einen oder mehrere Befehle mit seiner Syntax auf.
/scoreboard Verwaltet Teams und selbst definierte Punktestände.
/seed Nennt den Startwert der Welt.
/stats Verknüpft Befehlsquellen mit Punkteständen.
/testfor Prüft, ob ein Objekt eine Bedingung erfüllt.
/testforblock Prüft, ob sich ein bestimmter Block an einer bestimmten Position befindet.
/testforblocks Prüft, ob zwei Blockbereiche identisch sind.
Chat
Befehl Beschreibung
/me Sendet im Chat den Namen des Versenders zusammen mit einem Aktionstext.
/msg Identisch mit /tell.
/say Sendet im Chat eine Nachricht an alle Spieler.
/tell Sendet im Chat eine Nachricht an einen Spieler (flüstern genannt).
/tellraw Sendet im Chat eine Nachricht an einen Spieler, die formatiert und Maus-sensitiv sein kann.
/w Identisch mit /tell (engl. whisper).
Veränderung von Wesen (Spieler oder Kreatur)
Befehl Beschreibung
/achievement Gibt dem Spieler einen Erfolg.
/clear Entfernt Gegenstände aus dem Inventar des Spielers.
/effect Gibt dem Wesen einen Statuseffekt.
/enchant Gibt dem Gegenstand, den der Spieler in der Hand hält, eine Verzauberung.
/entitydata Verändert die Eigenschaften einer Kreatur.
/execute Lässt das Wesen einen Befehl ausführen.
/gamemode Verändert den Spielmodus des Spielers.
/give Gibt Gegenstände in das Inventar des Spielers.
/kill Tötet das Wesen sofort.
/particle Lässt Partikel um das Wesen erscheinen.
/playsound Spielt ein Geräusch für den Spieler ab.
/replaceitem Ersetzt Gegenstände im Inventar des Wesens.
/scoreboard Ordnet das Objekt (Wesen oder lebloses Objekt) einem Team zu oder ändert seinen Punktestand.
/spawnpoint Ändert den Spawnpunkt des Spielers.
/spreadplayers Verteilt die Wesen innerhalb eines vorgegebenen Bereiches in der Landschaft.
/stopsound Beendet das Abspielen eines Geräusches für den Spieler.
/title Zeigt dem Spieler einen Titelbildschirm an.
/tp
/teleport
Teleportiert das Wesen zum Ziel und /oder dreht es.
/trigger Ändert den Punktestand des Spielers.
/xp Gibt dem Spieler Erfahrungspunkte.
Veränderung der Welt
Befehl Beschreibung
/blockdata Verändert die Tile Entity-Daten eines Blockes in der Welt.
/clone Kopiert einen ganzen Blockbereich an eine andere Position.
/defaultgamemode Verändert den Spielmodus der Welt.
/difficulty Verändert den Schwierigkeitsgrad der Welt.
/fill Füllt einen Bereich mit einem bestimmten Block oder mit Luft.
/gamerule Ändert eine Grundeinstellung der Welt.
/particle Lässt Partikel an einer bestimmten Position in der Welt erscheinen.
/publish Stellt die Welt zum gemeinsamen Spielen in einem LAN (lokalen Netzwerk) zur Verfügung.
/replaceitem Ersetzt Gegenstände im Inventar eines Behälters.
/setblock Platziert oder löscht einen Block an einer bestimmten Position in der Welt.
/setworldspawn Verändert den Spawnbereich der Welt.
/summon Holt ein Objekt (Kreatur etc.) in die Welt.
/time Ändert die Weltzeit.
/toggledownfall Stoppt oder startet einen Niederschlag in der Welt.
/weather Ändert das Wetter in der Welt.
/worldborder Setzt eine Grenze um die Welt.
Server-Verwaltung
Befehl Beschreibung
/ban Sperrt einen Spieler dauerhaft vom Server.
/ban-ip Sperrt eine IP-Adresse dauerhaft vom Server.
/banlist Zeigt alle gesperrten Spieler oder IP-Adressen des Servers an.
/deop Entfernt die Operator-Rechte von einem Spieler für diesen Server.
/kick Entfernt einen aktiven Spieler sofort vom Server.
/list Listet alle aktiven Spieler des Servers auf.
/op Gibt Operator-Rechte für diesen Server an einen Spieler.
/pardon Hebt den Bann eines Spielers für den Server auf.
/pardon-ip Hebt den Bann einer IP-Adresse für den Server auf.
/save-all Sichert die Welt sofort auf dem Server.
/save-off Stellt das automatische Sichern der Welt auf dem Server aus.
/save-on Stellt das automatische Sichern der Welt auf dem Server an.
/setidletimeout Setzt eine Grenze, wie lange Spieler unbeweglich auf dem Server herumstehen dürfen.
/stop Stoppt den Server sofort und fährt ihn herunter.
/whitelist Verwaltung der Liste der erlaubten Spielernamen für den Server.

Eingabe[Bearbeiten | Quelltext bearbeiten]

Tab-Taste[Bearbeiten | Quelltext bearbeiten]

Die Tab ↹-Taste ist bei der Eingabe von Befehlen und Parametern eine große Hilfe, denn sie listet mögliche Eingaben auf und wechselt zwischen ihnen. Beispiele:
/togTab ↹ vervollständigt die einzige Möglichkeit und ergibt: /toggledownfall
/dTab ↹ listet alle Möglichkeiten zur Vervollständigung auf und ergibt: /difficulty, /debug, /defaultgamemode. Erneutes Drücken von Tab ↹ wechselt zwischen diesen drei Möglichkeiten.
/debugLeertasteTab ↹ listet den gleichlautenden Beginn der Eingabemöglichkeiten für den /debug-Befehl auf: st. Wichtig ist dabei die Leertaste. Erneutes Drücken von Tab ↹ zeigt beide an: start, stop. Erneutes Drücken von Tab ↹ wechselt zwischen den beiden Möglichkeiten.

Parameter[Bearbeiten | Quelltext bearbeiten]

Die meisten Befehle haben zusätzliche Parameter. Davon gibt es zwei verschiedene Arten, die entsprechend gekennzeichnet sind:

  • <Muss-Parameter> stehen in spitzen Klammern. Diese Parameter muss man eingeben, damit der Befehl funktioniert.
  • [Kann-Parameter] stehen in eckigen Klammern. Diese Parameter kann man zusätzlich eingeben, wenn man möchte.

Wichtig:

  • Die Parameter werden immer durch Leerzeichen voneinander getrennt.
  • Die spitzen und eckigen Klammern gehören nicht zum Parameter. Sie kennzeichnen nur die Parameter-Art.
  • Die Parameter sind immer Platzhalter, d. h. an ihrer Stelle muss im Befehl ein passender Wert geschrieben werden.

Koordinaten-Schnelleingabe[Bearbeiten | Quelltext bearbeiten]

Einige Befehle erfordern die Eingabe von X-, Y- und Z-Koordinaten. Wenn man möchte, kann man diese ohne Eintippen von dem Block übernehmen, den man anschaut. Im Debug-Bildschirm sieht man diese Koordinaten unter "Looking at". Man übernimmt sie, indem man an der entsprechenden Stelle des Befehls LeertasteTab ↹LeertasteTab ↹LeertasteTab ↹ drückt. Schaut man keinen Block an, werden die Koordinaten ~ ~ ~ vervollständigt. Diese bezeichnen die Position, an der sich der Spieler oder eine andere Befehlsquelle gerade befindet.

Beispiele:

  • Um einen Block in Wolle zu verwandeln, schaut man ihn an und gibt ein: /setblock Tab ↹ Tab ↹ Tab ↹ wool
  • Um einen gewissen Bereich mit Stein zu füllen, schaut man auf einen Eckpunkt des Bereiches und gibt ein: /fill Tab ↹ Tab ↹ Tab ↹ ↵ Eingabe. Da der Befehl nicht vollständig war, erhält man eine Fehlermeldung, die man ignoriert. Dann geht man zum diagonal gegenüberliegenden Eckpunkt, schaut diesen an (wenn er in der Luft ist, setzt man dort einen Hilfsblock, den man anschauen kann), holt sich im Chat durch die -Taste die vorige Eingabe zurück und vervollständigt sie mit Tab ↹ Tab ↹ Tab ↹ stone.

NBT-Daten[Bearbeiten | Quelltext bearbeiten]

Mit dem Parameter NBT-Daten, den einige Befehle enthalten, steht ein sehr mächtiges Werkzeug zur Verfügung. Damit kann die umfangreiche Datenstruktur von Minecraft genutzt werden. Diese wird zur Verwaltung aller Spielelemente und beim Speichern der Welt verwendet. Die Datenstruktur von Minecraft ist baumartig aufgebaut nach dem sogenannten NBT-Format. Mit den NBT-Daten können bei einigen Befehlen Teile dieser Datenstruktur als Parameter übergeben werden. Zur Schreibweise sind JSON-Markierungen zu verwenden (siehe dort).

Anwendung[Bearbeiten | Quelltext bearbeiten]

Beispiel für einen Datenbaum

Zur Anwendung von NBT-Daten muss man sehr genau sein, sonst misslingt der Befehl. Dazu kann man wie folgt vorgehen:

1. Feststellung der richtigen Daten
Die NBT-Daten eines Gegenstandes unterscheiden sich beispielsweise von denen einer Kreatur. Daher muss man zuerst wissen, was man mit dem Befehl ansprechen will. Daraus ergeben sich die zugehörigen NBT-Daten:

2. Analyse der Baumstruktur
Wenn man die richtigen Daten festgestellt hat, schaut man sich im entsprechenden Artikel die Baumstruktur der Daten an. Beispiel: ein Banner hat folgende Blockobjektdaten:


  •  Base: Grundfarbe

  •  Patterns: Liste der Muster

    • Ein Muster

      •  Color: Musterfarbe

      •  Pattern: Musterart

Die Baumstruktur beginnt hier mit den beiden Eigenschaften Base und Patterns. Base ist eine Zahl und Patterns ist eine Liste, wie man an den Symbolen erkennt, über die man auch mit der Maus fahren kann. Sie sind im Artikel NBT-Format erklärt. Die Datentypen List und Compound sind sozusagen Behälter für weitere Eigenschaften. Sie bedeuten eine Verzweigung des Datenbaumes in viele Äste. Im Artikel wird aber immer nur ein Exemplar der Verzweigung genannt. Für das Banner bedeutet das: Die Patterns-Liste kann viele Muster enthalten. Jedes Muster hat dann zwei weitere Verzweigungen bzw. Eigenschaften: Color und Pattern.

3. Übertragung der Baumstruktur in JSON
Zum Aufschreiben der Baumstruktur wird in Minecraft die JavaScript Object Notation JSON verwendet. Diese hat bestimmte Regeln, an die man sich genau halten muss. Verzweigungen der Baumstruktur werden durch geschweifte bzw. eckige Klammern dargestellt, wobei geschweifte beim Datentyp Compound anzuwenden sind, eckige beim Datentyp List. Details siehe den JSON-Artikel. Für ein Banner mit zwei Mustern sieht die Baumstruktur in JSON so aus:

{
  Base:Wert,
  Patterns:
  [
    {
      Color:Wert,
      Pattern:Wert
    },
    {
      Color:Wert,
      Pattern:Wert
    }
  ]
}

4. Einsetzen der Werte
Jeder Wert ist von einem bestimmten Datentyp. Texte sind vom Datentyp String, Zahlen können Byte, Short, Int, Long, Float oder Double sein. Das erkennt man am Symbol des Wertes. Beispielsweise hat beim Banner die Color-Eigenschaft ein "I" im Symbol, ist also von Datentyp Int. Das sieht man auch, wenn man mit der Maus über das Symbol fährt. Je nach Datentyp muss man nun die richtige JSON-Schreibweise anwenden. Bei Zahlen wird dazu meist ein Buchstabe angehängt außer beim Datentyp Int. Details siehe den JSON-Artikel. Für ein Banner mit gelber Grundfarbe und zwei weißen Streifen links und rechts sieht das so aus:

{
  Base:11,
  Patterns:
  [
    {
      Color:15,
      Pattern:ls
    },
    {
      Color:15,
      Pattern:rs
    }
  ]
}

5. Einsetzen in den Befehl
Man kann alle NBT-Daten in eine Zeile schreiben:

setblock ~ ~1 ~ standing_banner 0 replace {Base:11, Patterns:[{Color:15,Pattern:ls}, {Color:15,Pattern:rs}]}

Bei umfangreichen oder verschachtelten NBT-Daten empfiehlt sich die strukturierte Schreibweise, die man direkt in einen Befehlsblock kopieren kann. Die Leerzeichen und Einrückungen stören Minecraft nicht bei der Durchführung des Befehls:

/setblock ~ ~1 ~ standing_banner 0 replace 
{
  Base:11,
  Patterns:
  [
    {
      Color:15,
      Pattern:ls
    },
    {
      Color:15,
      Pattern:rs
    }
  ]
}

6. Fehlersuche
Wenn der Befehl nicht erfolgreich durchgeführt wurde, gibt Minecraft eine mehr oder weniger hilfreiche Fehlermeldung aus. Nun gibt man den Befehl in extrem verkürzter Form ein, testet dies und vervollständigt ihn nach und nach, bis man die fehlerhafte Stelle eingrenzen und korrigieren kann. Wenn man den Fehler trotzdem nicht findet, kann man nach Beispielen dieses Befehls googeln. Beispiel:

/setblock ~ ~1 ~ standing_banner
/setblock ~ ~1 ~ standing_banner 0 replace
/setblock ~ ~1 ~ standing_banner 0 replace {Base:11}
/setblock ~ ~1 ~ standing_banner 0 replace {Base:11, Patterns:[{Color:15,Pattern:ls}]}
/setblock ~ ~1 ~ standing_banner 0 replace {Base:11, Patterns:[{Color:15,Pattern:ls}, {Color:15,Pattern:ls}]}

NBT-Daten für die Befehle[Bearbeiten | Quelltext bearbeiten]

Befehl Beispiel mit NBT-Daten NBT-Daten
Befehl /give Befehl /give @p leather_helmet 1 0 {display:{color:6591981} }
gibt eine Lederkappe in der Farbe kornblumenblau
Gegenstandsdaten
Befehl /clear Befehl /clear @p leather_helmet 0 1 {display:{color:6591981} }
löscht eine Lederkappe in der Farbe kornblumenblau
Gegenstandsdaten
Befehl /replaceitem Befehl /replaceitem entity @p slot.armor.head skull 1 3 {SkullOwner:MHF_Chicken}
setzt dem Spieler einen Hühnerkopf auf
Gegenstandsdaten
Befehl /setblock Befehl /setblock 385 65 84 standing_sign 0 replace {Text1:Willkommen}
stellt an Position 385/65/84 ein Schild auf mit dem Text "Willkommen" in Zeile 1
Blockobjektdaten
Befehl /testforblock Befehl /testforblock 385 65 84 standing_sign 0 {Text1:Willkommen}
prüft, ob an Position 385/65/84 ein Schild steht mit dem Text "Willkommen" in Zeile 1
Blockobjektdaten
Befehl /blockdata Befehl /blockdata 385 65 84 {Text1:Tschüss}
ändert an Position 385/65/84 den Text des Schildes in Zeile 1 auf "Tschüss"
Blockobjektdaten
Befehl /entitydata Befehl /entitydata @e[type=Pig,r=5] {Saddle:1}
setzt allen Schweinen im Umkreis von 5 Blöcken einen Sattel auf
Objektdaten
Kreaturdaten
Befehl /fill Befehl /fill 385 65 84 395 65 84 standing_sign 0 replace {Text1:Willkommen}
stellt ab Position 385/65/84 zehn Schilder in einer Reihe in X-Richtung auf mit dem Text "Willkommen" in Zeile 1
Blockobjektdaten
Befehl /summon Befehl /summon EntityHorse ~ ~ ~ {Type:4}
lässt ein Skelettpferd erscheinen
Objektdaten
Kreaturdaten
Befehl /testfor Befehl /testfor @a {OnGround:0b}
Prüft alle Spieler, ob einer fliegt
Spielerdaten
Objektdaten
Kreaturdaten
Befehl /scoreboard players Befehl /scoreboard players set @a punkte 10 {SelectedItem:{id:minecraft:stone} }
Setzt allen Spielern, die einen Stein in der Hand halten, das Ziel "punkte" auf den Wert 10.
Spielerdaten
Objektdaten
Kreaturdaten

Hinweise[Bearbeiten | Quelltext bearbeiten]

Durch das Einsetzen von Werten, die normalerweise nicht vom Programm verwendet werden, können Effekte erzielt werden, die nicht immer sinnvoll sind. Im schlimmsten Fall kann sogar das Spiel zum Absturz gebracht werden. Daher empfiehlt es sich, neue Werte und Kombinationen in einer Testwelt auszuprobieren, bevor man sie einsetzt.

Es können auch nicht alle Eigenschaften verändert werden. Bei einigen wird die Änderung vom Programm ignoriert (z.B. Zombiepferde mit anderer Fellfarbe). Eigenschaften, die nicht sichtbar sind (z.B. Gesundheitspunkte), kann man nur mit einem Programm wie dem "NBT-Explorer" überprüfen. In diesem Fall empfiehlt sich der Test in einer Welt vom Typ Flachland (d. h. ohne Höhlen) in Chunk 0/0, den man mit dem NBT-Explorer leicht finden kann (er liegt in der Region-Datei r.0.0.mca).

Wenn ein Befehl länger als 100 Zeichen ist, kann man ihn nicht mehr in der Chat-Konsole, sondern nur noch in einem Befehlsblock verwenden. Bei längeren Befehlen empfiehlt sich ein strukturierter Aufbau. Der Befehl kann auch in dieser strukturierten Form in einen Befehlsblock kopiert werden, es ist nicht notwendig, die Leerzeichen und Zeilenumbrüche zu entfernen.

Beispiel[Bearbeiten | Quelltext bearbeiten]

Eine "Hexenkönigin"
/summon EntityHorse ~ ~ ~ 
{
  Type:0,
  Tame:1,
  Variant:3,
  ArmorItem:
  {
    id:golden_horse_armor,
    Count:1
  },
  Passengers:
  [
    {
      id:Witch,
      HandItems:
      [
        {id:blaze_rod},
        {}
      ]
    }
  ]
}

Der Befehl erzeugt ein Pferd mit NBT-Daten. Das Pferd ist ein normales Pferd (Type:0), das zahm sein muss (Tame:1), sonst wirft es die Hexe gleich wieder ab. Es hat ein braunes Fell (Variant:3) und trägt eine Goldrüstung (id:golden_horse_armor). Reiter auf dem Pferd (Passengers) ist eine Hexe (id:Witch), die eine Lohenrute (id:blaze_rod) in der Hand hält. Die HandItems-Eigenschaft enthält immer zwei Gegenstände. Wird nur der erste angegeben, wird der zweite als leer angenommen, so dass man ihn in diesem Beispiel auch weglassen könnte.

Viele Beispiele mit NBT-Daten siehe: Anleitungen/Befehle mit NBT

Ziel-Auswahl[Bearbeiten | Quelltext bearbeiten]

In allen Nicht-Server-Befehlen, in denen der Parameter Spieler vorkommt, kann man statt eines konkreten Spielernamens auch alle Spieler oder Spieler mit bestimmten Eigenschaften auswählen. Bei einigen Befehlen können sogar Objekte als Ziel ausgewählt werden. Diese Ziel-Auswahl wird vor allem beim Befehlsblock eingesetzt, kann aber ebenso bei einem Befehl in der Chat-Konsole verwendet werden. Dazu ist grundsätzlich eine der vier Auswahlen anzugeben, die wahlweise mit weiteren Eigenschaften verbunden werden kann. Die einfache Ziel- Auswahl ist nur im Mehrspielermodus sinnvoll (funktioniert aber auch im Einzelspielermodus). Wenn Eigenschaften hinzugefügt werden, ist die Ziel-Auswahl auch im Einzelspielermodus sehr sinnvoll.

Spieler-Auswahl Bedeutung
@p
Der Spieler (p = player), der der Befehlsquelle (dem Befehlsblock oder dem ausführenden Spieler) am nächsten steht, wird ausgewählt.
@a
Alle Spieler (a = all) werden ausgewählt.
@r
Ein zufälliger Spieler (r = random), oder bei angegebenem Parameter type auch ein anderes Objekt, wird ausgewählt.
@e
Alle Objekte (e = entity) werden ausgewählt, d.h. alle Spieler, Kreaturen, Fahrzeuge, Drops, fliegenden Geschosse etc.

Wird die Ziel-Auswahl an Stelle eines Spieler-Parameters in einem Befehl verwendet, wird der Befehl nacheinander für alle gefundenen Ziele ausgeführt. Bei der Ziel-Auswahl "@e" kann das zu der Meldung "Dieser Spieler konnte nicht gefunden werden" führen, falls der Befehl nicht für die Anwendung auf ein beliebiges Objekt geeignet ist.

Wird die Ziel-Auswahl als Teil einer Chat-Nachricht versendet, wird sie im Nachrichtentext durch eine Liste der gefundenen Ziele ersetzt. Das kann man zum Testen der Ziel-Auswahl nutzen, indem man im Einzelspielermodus die Ziel-Auswahl mit dem Befehl /say verwendet, z.B. /say @e. Im Mehrspielermodus würde man dadurch allerdings eine Nachricht im Chat an alle Mitspieler senden.

Um eine Ziel-Auswahl mit einer oder mehreren Eigenschaften zu verbinden, müssen diese direkt und ohne Leerzeichen an die Ziel-Auswahl anschließen. Auch die Aufzählung der Eigenschaften darf keinerlei Leerzeichen enthalten. Die Syntax ist wie folgt: Ziel-Auswahl[Eigenschaft=Wert,Eigenschaft=Wert,...]. Wird eine Eigenschaft mehrfach aufgezählt, wirkt immer nur die letzte Aufzählung. Es ist also z.B. nicht möglich, mehrere Spieler- oder Teamnamen anzugeben.

Die Eigenschaften teilen sich in drei Gruppen:

  • Einschränkung des Auswahlbereiches. Ohne Einschränkung ist der Auswahlbereich die ganze Welt.
  • Einschränkung der Auswahlmenge. Ohne Einschränkung sind das alle Ziele im Auswahlbereich.
  • Einschränkung der Zieleigenschaften.
Eigenschaft Bedeutung
x y z Koordinaten für den Mittelpunkt des Auswahlbereiches (bei Angabe eines Radius bzw. für eine Ecke bei der Auswahl eines Quaderbereichs). Für jede Koordinate, die weggelassen wird, wird die entsprechende Koordinate der Befehlsquelle verwendet, d. h. ohne Angabe einer einzigen Koordinate ist die Befehlsquelle der Mittelpunkt des Auswahlbereiches. Ein Spieler wird gefunden, wenn sich seine Füße im Auswahlbereich befinden, der Kopf wird nicht geprüft. Hierbei sind weder relative Zahlen (wie x=~7) noch Kommazahlen als Koordinaten möglich. In beiden Fällen wird kein Spieler gefunden.
r Maximaler Radius in Blöcken um den Mittelpunkt des Auswahlbereiches. Ausgewählt werden nur Ziele, die innerhalb oder auf dem Radius liegen. Da der Radius in Blöcken gemessen wird, ist der Auswahlbereich immer würfel- und nicht kugelförmig. Wird der Radius weggelassen oder mit einem Wert kleiner/gleich 0 belegt, wird die ganze Welt einbezogen. Der kleinste Auswahlbereich beträgt genau einen Block.
rm Mindestradius in Blöcken um den Mittelpunkt des Auswahlbereiches. Ausgewählt werden nur Ziele, die außerhalb oder auf dem Mindestradius liegen. Damit kann z.B. ein Spieler als Befehlsquelle steuern, dass er selbst oder die Gruppe, die dicht um ihn steht, nicht einbezogen wird.
dx dy dz Für den Auswahlbereich kann statt Angabe eines Radius auch die Ausdehnung (engl. dimension) eines Quaders angegeben werden. Damit ist es möglich, nicht nur würfelförmige Quader (gleicher Blockradius in alle Richtungen), sondern Quader in ganz bestimmter Form und Größe als Auswahlbereich anzugeben. Die Position x y z beschreibt dabei den einen Eckpunkt des Quaders. Der diagonal gegenüberliegende andere Eckpunkt wird nicht direkt angegeben, sondern ergibt sich aus Addition der Werte dx dy dz. Negative Werte sind für dx dy dz möglich. Es müssen nicht alle drei Werte angegeben werden. Nicht angegebene Werte werden als 0 angesehen. Man kann dx dy dz mit r kombinieren, wobei der erstandene Auswahlbereich dann der Raum ist, den beide Angaben einschließen.
c Einschränkung der Auswahlmenge. Wenn sich weniger als c Ziele im Auswahlbereich befinden, hat diese Einschränkung keine Auswirkung. Ansonsten werden bei positivem c nur die c Spieler ausgewählt, die dem Mittelpunkt des Auswahlbereiches am nächsten sind und bei negativem c die c Spieler, die vom Mittelpunkt am weitesten entfernt sind. Das gilt für alle vier Ziel-Auswahlen.
m Spielereigenschaft: Spielmodus (0 = Überlebensmodus, 1 = Kreativmodus, 2 = Abenteuer-Modus, 3 = Zuschauermodus).
l Spielereigenschaft: maximales Erfahrungslevel. Spieler, die mehr Erfahrung haben, werden nicht ausgewählt.
lm Spielereigenschaft: minimales Erfahrungslevel. Spieler, die weniger Erfahrung haben, werden nicht ausgewählt.
rx Spielereigenschaft: Maximaler Kopfneigungswinkel. Wertebereich ist -90 (senkrecht nach oben) über 0 (waagerecht) bis 90 (senkrecht nach unten). Objekte, welche ihre Kopfneigung nicht in der Rotation-Eigenschaft speichern, wie zum Beispiel Rüstungsständer, werden mit 0 ausgewählt. Kommazahlen sind nicht möglich. Spieler, die einen größeren Kopfneigungswinkel haben, werden nicht ausgewählt, wobei -50 kleiner ist als -40 und 40 kleiner als 50. Der Kopfneigungswinkel kann über den Debug-Bildschirm bei "Facing" abgelesen werden. In Verbindung mit anderen Ziel-Auswahl-Eigenschaften kann z.B. ein Spieler ausgewählt werden, der an einer ganz bestimmten Position steht und dabei einen bestimmten Gegenstand anschaut (indem er in eine ganz bestimmte Richtung schaut).
rxm Spielereigenschaft: Minimaler Kopfneigungswinkel. Spieler, die einen kleineren Kopfneigungswinkel haben, werden nicht ausgewählt. Ansonsten siehe rx. Durch die Kombination von rxm und rx kann ein bestimmter Kopfneigungswinkel auf 1 Grad genau eingeschränkt werden.
ry Spielereigenschaft: Maximaler Blickrichtungswinkel. Wertebereich ist -180 (Norden) über -90 (Osten), 0 (Süden), 90 (Westen) bis 180 (Norden). Kommazahlen sind nicht möglich. Spieler, die einen größeren Blickrichtungswinkel haben, werden nicht ausgewählt, wobei -50 kleiner ist als -40 und 40 kleiner als 50. Der Blickrichtungswinkel kann über den Debug-Bildschirm bei "Facing" abgelesen werden. In Verbindung mit anderen Ziel-Auswahl-Eigenschaften kann z.B. ein Spieler ausgewählt werden, der an einer ganz bestimmten Position steht und dabei einen bestimmten Gegenstand anschaut (indem er in eine ganz bestimmte Richtung schaut).
rym Spielereigenschaft: Minimaler Blickrichtungswinkel. Spieler, die einen kleineren Blickrichtungswinkel haben, werden nicht ausgewählt. Ansonsten siehe ry. Durch die Kombination von rym und ry kann ein bestimmter Blickrichtungswinkel auf 1 Grad genau eingeschränkt werden.
score_name Spielereigenschaft: Höchst-Punktestand für das Ziel, das in der Anzeigetafel mit dem internen Namen name hinterlegt ist. Spieler, die mehr Punkte haben, werden nicht ausgewählt.
score_name_min Spielereigenschaft: Mindest-Punktestand für das Ziel, das in der Anzeigetafel mit dem internen Namen name hinterlegt ist. Spieler, die weniger Punkte haben, werden nicht ausgewählt.
team Spielereigenschaft: Mitgliedschaft in einem Anzeigetafel-Team. Hierbei wird der interne Name des Teams abgefragt. Mit einem ! vor dem internen Namen wird die Abfrage zu einer Negation. Bei keiner Angabe eines Team-Namen sind die Spieler betroffen, die keinem Team angehören.
name Zieleigenschaft: Name des Spielers oder der Kreatur. Mit einem ! vor dem Namen wird die Auswahl zu einer Negation.
type Zieleigenschaft: Objekt-ID des Ziels. Mit einem ! vor der Objekt-ID wird die Auswahl zu einer Negation. Die Groß- und Kleinschreibung bei den Objekt-IDs ist genau zu beachten. Für die Berücksichtigung von Spielern gibt es die spezielle ID Player.
tag Zieleigenschaft: Ein Objekt kann mit einem oder mehreren Freitext-Etiketten versehen werden (siehe Objektdaten-Eigenschaft Tags), die man abfragen kann, um das Objekt auszuwählen. Mit einem ! vor dem Etikett wird die Auswahl zu einer Negation.

Die Koordinaten x, y, z und der Radius r der Ziel-Auswahl können abgekürzt werden, indem man nur ihren Wert ohne Eigenschaft-Namen und Gleichheitszeichen schreibt. Die Eigenschaft ergibt sich dann aus der Position in der Liste der Eigenschaften, d. h. die erste Eigenschaft ohne Namen ist immer die X-Koordinate, die vierte ohne Namen immer der Radius. Um bei dieser Schreibweise eine Eigenschaft wegzulassen, wird nur das Komma ohne Wert geschrieben.

Bei mehrfacher Aufzählung derselben Eigenschaft wirkt immer nur die letzte Aufzählung (das gilt für alle Eigenschaften).

Beispiel Bedeutung
@a[x=100,y=60,z=-80,r=40]

@a[100,60,-80,40]

Alle Spieler in einem würfelförmigen Bereich mit dem Radius 40 um den Mittelpunkt 100/60/-80.
@a[x=100,y=60,z=-80,dx=4,dy=2,dz=5] Alle Spieler in dem Quader, der durch die diagonalen Eckpunkte 100/60/-80 und 104/62/-75 beschrieben wird.
@a[r=40]

@a[,,,40]

Alle Spieler in einem würfelförmigen Bereich mit dem Radius 40 um die Befehlsquelle als Mittelpunkt.
@p[r=40,rm=10] Der nächste Spieler, der mindestens 10 und maximal 40 Blöcke von der Befehlsquelle entfernt ist. Wenn kein Spieler in diesem Bereich ist, schlägt der Befehl fehl.
@a[x=100,y=64,z=-100,c=10,r=5] Die 10 nächsten Spieler innerhalb von 5 Blöcken um 100/64/-100.
@p[0,64,0,c=-2] Die zwei weitesten Spieler um 0/64/0.
@a[,,,10,c=5] Die fünf nächsten Spieler innerhalb 10 Blöcken um die aktuelle Position.
@a[m=1] Alle Spieler im Kreativmodus.
@p[x=1,y=70,z=26,r=10,rm=2,m=1,c=3,l=25,lm=3] Die nächsten 3 Spieler im Kreativmodus in einem Radius von 2-10 Blöcken um 1/70/26, die einen Erfahrungslevel zwischen 3 und 25 haben.
@a[x=1,y=70,z=26,dx=0,dy=0,dz=0,rym=102,ry=103,rxm=-40,rx=-39] Alle Spieler die auf der Position 1/70/26 stehen (ein Bereich der an dieser Position beginnt und eine Ausdehnung von 0 in alle Richtungen hat, also nur genau einen Block groß ist), die nach Westen schauen (im Winkel zwischen 102 und 103 Grad) und ihren Kopf schräg nach oben neigen (im Winkel -40 bis -39 Grad).
@a[score_Tore_min=1,score_Tore=5] Alle Spieler, die mindestens eins und höchstens fünf Tore geschossen haben. Die Erhöhung der Anzahl geschossener Tore (oder jedes anderen selbst definierten Anzeigetafel-Ziels) für einen Spieler erfolgt über den Befehl /scoreboard.
@a[team=!Team1,team=!Team2] Alle Spieler, die nicht zum Team mit dem internen Namen Team2 gehören, da bei mehrfacher Aufzählung derselben Eigenschaft nur die letzte Aufzählung wirkt.
@a[team=] Alle Spieler, die zu keinem Team gehören.
@a[team=!] Alle Spieler, die zu irgendeinem Team gehören.
@a[name=oyo123,lm=30] Alle Spieler mit dem Namen oyo123 und einem Erfahrungslevel von mindestens 30. Der Befehl ist erfolgreich, sobald oyo123 ein Erfahrungslevel von mindestens 30 hat.
@a[name=!oyo123] Alle Spieler außer dem mit dem Namen oyo123.
@e[type=Creeper,c=5] Die 5 Creeper, die der Befehlsquelle am nächsten sind.
@e[type=!Player,r=10] Alle Objekte in einem Umkreis von 10 Blöcken, nicht jedoch Spieler in diesem Bereich.

Befehl /summon Zombie ~ ~ ~ {Tags:[Schurke,Halunke]}
@e[tag=Halunke]
Ein Zombie erscheint mit den Etiketten "Schurke" und "Halunke". Wenn alle Objekte mit dem Etikett "Halunke" ausgewählt werden, ist dieser Zombie mit dabei. Man kann mit tag immer nur ein Etikett auswählen. Gibt man tag mehrfach an, gilt immer die letzte Auswahl. Um mehrere tags eines Objektes zu erkennen, wird der Befehl /execute benötigt (siehe Beispiel dort).

Eine Einschränkung auf Objekte mit bestimmten NBT-Eigenschaften ist über die Zielauswahl nicht direkt möglich. Stattdessen kann man diesen Objekten ein spezielles Etikett geben, um sie darüber anzusprechen.

Beispiel:
Von den herumliegenden Drops sollen alle Diamantschwerter verschwinden, die restlichen Drops sollen bleiben.

  • Der Befehl /scoreboard players tag @e[type=Item] add diaschwert {Item:{id:"minecraft:diamond_sword"} } gibt allen Diamantschwert-Drops das Etikett "diaschwert". Wenn gerade kein Diamantschwert-Drop herumliegt, bewirkt dieser Befehl nichts.
  • Der Befehl /execute @e[type=Item] ~ ~ ~ kill @e[tag=diaschwert] löscht alle Drops mit einem diaschwert-Etikett.

Galerie[Bearbeiten | Quelltext bearbeiten]

Geschichte[Bearbeiten | Quelltext bearbeiten]

Einzelnachweise[Bearbeiten | Quelltext bearbeiten]