Den Beispieltest ausführen
/test run minecraft:always_passFührt den einzigen Test des Grundspiels aus und meldet das Ergebnis im Chat.
/test Befehl in Minecraft
/test führt GameTests aus, erstellt und verwaltet sie. Das sind automatische Tests aus einer Konstruktion und einer Testlogik. Mojang prüft damit selbst Spielmechaniken, und Autoren von Datenpaketen kontrollieren so, ob ihre Anlagen und Funktionen nach Änderungen noch laufen.
Syntax
/test (clearall|clearthat|clearthese|create|locate|pos|resetclosest|resetthat|resetthese|run|runclosest|runfailed|runmultiple|runthat|runthese|stop|verify)Alle 41 Formen
- /test clearall
- /test clearall <radius>
- /test clearthat
- /test clearthese
- /test create <id>
- /test create <id> <width>
- /test create <id> <width> <height> <depth>
- /test locate <tests>
- /test pos
- /test pos <var>
- /test resetclosest
- /test resetthat
- /test resetthese
- /test run <tests>
- /test run <tests> <numberOfTimes>
- /test run <tests> <numberOfTimes> <untilFailed>
- /test run <tests> <numberOfTimes> <untilFailed> <rotationSteps>
- /test run <tests> <numberOfTimes> <untilFailed> <rotationSteps> <testsPerRow>
- /test runclosest
- /test runclosest <numberOfTimes>
- /test runclosest <numberOfTimes> <untilFailed>
- /test runfailed
- /test runfailed <numberOfTimes>
- /test runfailed <numberOfTimes> <untilFailed>
- /test runfailed <numberOfTimes> <untilFailed> <rotationSteps>
- /test runfailed <numberOfTimes> <untilFailed> <rotationSteps> <testsPerRow>
- /test runfailed <onlyRequiredTests>
- /test runfailed <onlyRequiredTests> <numberOfTimes>
- /test runfailed <onlyRequiredTests> <numberOfTimes> <untilFailed>
- /test runfailed <onlyRequiredTests> <numberOfTimes> <untilFailed> <rotationSteps>
- /test runfailed <onlyRequiredTests> <numberOfTimes> <untilFailed> <rotationSteps> <testsPerRow>
- /test runmultiple <tests>
- /test runmultiple <tests> <amount>
- /test runthat
- /test runthat <numberOfTimes>
- /test runthat <numberOfTimes> <untilFailed>
- /test runthese
- /test runthese <numberOfTimes>
- /test runthese <numberOfTimes> <untilFailed>
- /test stop
- /test verify <tests>
/test clearall/test clearall [<radius>]| Argument | Erwartet | Was es macht |
|---|---|---|
| radiusoptional | Ganzzahl | Entfernung in Blöcken um dich herum, in der Testaufbauten entfernt werden. |
Alle 2 Formen
- /test clearall
- /test clearall <radius>
/test clearthat/test clearthat/test clearthese/test clearthese/test create/test create <id> [<width> [<height> <depth>]]| Argument | Erwartet | Was es macht |
|---|---|---|
| id | Ressourcen-ID | ID des neuen Tests, etwa blockaria:door_test, in deinem eigenen Namensraum. |
| widthoptional | Ganzzahl | Breite des Testbereichs, gemessen in Blöcken. |
| heightoptional | Ganzzahl | Höhe des Testbereichs in Blöcken, zusammen mit depth angegeben. |
| depthoptional | Ganzzahl | Tiefe des Testbereichs in Blöcken, zusammen mit height angegeben. |
Alle 3 Formen
- /test create <id>
- /test create <id> <width>
- /test create <id> <width> <height> <depth>
/test locate/test locate <tests>| Argument | Erwartet | Was es macht |
|---|---|---|
| tests | IDs (Platzhalter) · test_instance | Ziel-Tests: eine ID wie minecraft:always_pass oder ein Muster für mehrere Tests. |
/test pos/test pos [<var>]| Argument | Erwartet | Was es macht |
|---|---|---|
| varoptional | Textein Wort | Optionaler Name für die Position im Ergebnis, das im Chat erscheint. |
Alle 2 Formen
- /test pos
- /test pos <var>
/test resetclosest/test resetclosest/test resetthat/test resetthat/test resetthese/test resetthese/test run/test run <tests> [<numberOfTimes> [<untilFailed> [<rotationSteps> [<testsPerRow>]]]]| Argument | Erwartet | Was es macht |
|---|---|---|
| tests | IDs (Platzhalter) · test_instance | Ziel-Tests: eine ID wie minecraft:always_pass oder ein Muster für mehrere Tests. |
| numberOfTimesoptional | Ganzzahlmindestens 0 | Wie oft jeder Test läuft, ab 0. |
| untilFailedoptional | true / false | true beendet die Wiederholungen, sobald ein Test fehlschlägt. |
| rotationStepsoptional | Ganzzahl | Anzahl der Vierteldrehungen, die vor dem Start auf den Testaufbau angewendet werden. |
| testsPerRowoptional | Ganzzahl | Wie viele Tests nebeneinander in einer Reihe platziert werden. |
Alle 5 Formen
- /test run <tests>
- /test run <tests> <numberOfTimes>
- /test run <tests> <numberOfTimes> <untilFailed>
- /test run <tests> <numberOfTimes> <untilFailed> <rotationSteps>
- /test run <tests> <numberOfTimes> <untilFailed> <rotationSteps> <testsPerRow>
/test runclosest/test runclosest [<numberOfTimes> [<untilFailed>]]| Argument | Erwartet | Was es macht |
|---|---|---|
| numberOfTimesoptional | Ganzzahlmindestens 0 | Wie oft jeder Test läuft, ab 0. |
| untilFailedoptional | true / false | true beendet die Wiederholungen, sobald ein Test fehlschlägt. |
Alle 3 Formen
- /test runclosest
- /test runclosest <numberOfTimes>
- /test runclosest <numberOfTimes> <untilFailed>
/test runfailed/test runfailed [<numberOfTimes>|<onlyRequiredTests>]| Argument | Erwartet | Was es macht |
|---|---|---|
| numberOfTimesoptional | Ganzzahlmindestens 0 | Wie oft jeder Test läuft, ab 0. |
| untilFailedoptional | true / false | true beendet die Wiederholungen, sobald ein Test fehlschlägt. |
| rotationStepsoptional | Ganzzahl | Anzahl der Vierteldrehungen, die vor dem Start auf den Testaufbau angewendet werden. |
| testsPerRowoptional | Ganzzahl | Wie viele Tests nebeneinander in einer Reihe platziert werden. |
| onlyRequiredTestsoptional | true / false | true führt nur fehlgeschlagene Tests erneut aus, die als erforderlich markiert sind. |
Alle 10 Formen
- /test runfailed
- /test runfailed <numberOfTimes>
- /test runfailed <numberOfTimes> <untilFailed>
- /test runfailed <numberOfTimes> <untilFailed> <rotationSteps>
- /test runfailed <numberOfTimes> <untilFailed> <rotationSteps> <testsPerRow>
- /test runfailed <onlyRequiredTests>
- /test runfailed <onlyRequiredTests> <numberOfTimes>
- /test runfailed <onlyRequiredTests> <numberOfTimes> <untilFailed>
- /test runfailed <onlyRequiredTests> <numberOfTimes> <untilFailed> <rotationSteps>
- /test runfailed <onlyRequiredTests> <numberOfTimes> <untilFailed> <rotationSteps> <testsPerRow>
/test runmultiple/test runmultiple <tests> [<amount>]| Argument | Erwartet | Was es macht |
|---|---|---|
| tests | IDs (Platzhalter) · test_instance | Ziel-Tests: eine ID wie minecraft:always_pass oder ein Muster für mehrere Tests. |
| amountoptional | Ganzzahl | Anzahl der Kopien der gewählten Tests in diesem Durchlauf. |
Alle 2 Formen
- /test runmultiple <tests>
- /test runmultiple <tests> <amount>
/test runthat/test runthat [<numberOfTimes> [<untilFailed>]]| Argument | Erwartet | Was es macht |
|---|---|---|
| numberOfTimesoptional | Ganzzahlmindestens 0 | Wie oft jeder Test läuft, ab 0. |
| untilFailedoptional | true / false | true beendet die Wiederholungen, sobald ein Test fehlschlägt. |
Alle 3 Formen
- /test runthat
- /test runthat <numberOfTimes>
- /test runthat <numberOfTimes> <untilFailed>
/test runthese/test runthese [<numberOfTimes> [<untilFailed>]]| Argument | Erwartet | Was es macht |
|---|---|---|
| numberOfTimesoptional | Ganzzahlmindestens 0 | Wie oft jeder Test läuft, ab 0. |
| untilFailedoptional | true / false | true beendet die Wiederholungen, sobald ein Test fehlschlägt. |
Alle 3 Formen
- /test runthese
- /test runthese <numberOfTimes>
- /test runthese <numberOfTimes> <untilFailed>
/test stop/test stop/test verify/test verify <tests>| Argument | Erwartet | Was es macht |
|---|---|---|
| tests | IDs (Platzhalter) · test_instance | Ziel-Tests: eine ID wie minecraft:always_pass oder ein Muster für mehrere Tests. |
Beispiele
Den nächsten Test ausführen
/test runclosestFührt den Test aus, der dir am nächsten ist, praktisch beim Bauen.
Einen neuen Test anlegen
/test create blockaria:door_test 5Legt einen neuen Test namens blockaria:door_test mit der Größe 5 an.
Stell deinen Befehl zusammenFelder ausfüllen, dann den Befehl kopieren.
BefehlsgeneratorTests und Testinstanzen
Ein Test ist ein Eintrag test_instance in einem Datenpaket: Er nennt eine Konstruktion, eine Umgebung und einen Typ, function oder block_based. Das Spiel liefert nur ein Beispiel mit, minecraft:always_pass. In der Welt verwaltet ein Testinstanzblock jeden Test. Testpakete installierst du mit /datapack.
Ausführen und aufräumen
test run nimmt einen oder mehrere Tests, runclosest führt den nächsten aus, runfailed wiederholt Fehlschläge. Am Ende meldet der Chat Spielüberprüfung abgeschlossen! mit der Zahl der Tests. clearall entfernt Testaufbauten in deiner Nähe, locate findet, wo Tests stehen.
✓ Geprüft in der Java Edition 26.3 · aktualisiert am 2. November 2026
/test: FAQ
Welche Tests gibt es im Grundspiel?
Nur minecraft:always_pass, ein Beispiel, das sofort besteht. Alle anderen Tests kommen aus Datenpaketen oder Mods.
Wie wiederhole ich nur die fehlgeschlagenen Tests?
Mit /test runfailed. Steht true als erster Wert, laufen nur fehlgeschlagene Tests erneut, die als erforderlich markiert sind.
Wie benutze ich /test?
Gib ihn mit aktivierten Cheats im Chat ein: /test clearall [<radius>].
Wer kann /test benutzen?
Cheats an oder Operator Stufe 2.
Seit wann gibt es /test?
Er steht seit der Java Edition 1.21.5 im offiziellen Befehlsbaum.