Einen Wert zurückgeben
/return 1Beendet die Funktion sofort und gibt 1 zurück. In einer .mcfunction-Datei ohne Schrägstrich schreiben.
/return Befehl in Minecraft
/return beendet die laufende Funktion und gibt dem aufrufenden Befehl einen Wert zurück. /return fail lässt den Aufruf stattdessen scheitern, und /return run liefert das Ergebnis eines anderen Befehls. So werden Funktionen zu wiederverwendbaren Prüfungen für /execute if function und /execute store.
Syntax
/return fail/return run …/return <value>| Argument | Erwartet | Was es macht |
|---|---|---|
| value | Ganzzahl | Ganze Zahl, die an den Aufrufer zurückgeht; execute if function wertet 0 als gescheiterte Prüfung. |
Beispiele
Die Funktion scheitern lassen
/return failBeendet die Funktion als fehlgeschlagen: execute if function gelingt nicht, store success speichert 0.
Früh abbrechen per Prüfung
/execute unless entity @s[tag=ready] run return 0Am Anfang einer Funktion beendet die Zeile sie für jeden Ausführenden ohne das Etikett ready.
Funktion als Prüfung nutzen
/execute if function mypack:has_key run say Tür entriegeltFührt mypack:has_key aus und sendet die Nachricht nur, wenn sie einen Wert ungleich 0 zurückgibt.
Den Rückgabewert speichern
/execute store result score total calc run function mypack:count_mobsSchreibt die Zahl, die mypack:count_mobs zurückgibt, beim erfundenen Namen total in das Punkte-Ziel calc.
Stell deinen Befehl zusammenFelder ausfüllen, dann den Befehl kopieren.
BefehlsgeneratorRückgabewerte in der Praxis
In einer Funktion beendet return 1 die Datei sofort: Die Zeilen darunter laufen nicht mehr. Der Wert geht an das, was die Funktion aufgerufen hat. Im Chat antwortet /function mit „Funktion ... lieferte 1 zurück“. execute if function gelingt, wenn der Wert nicht 0 ist, und execute store result schreibt ihn in einen Punktestand von /scoreboard.
return fail beendet die Funktion als Fehlschlag: execute if function scheitert, und store success speichert 0. return run führt einen Befehl aus und gibt dessen Ergebnis zurück, etwa return run scoreboard players get @s coins, um einen Punktestand zurückzugeben.
Muster
- Früher Ausstieg:
execute unless entity @s[tag=ready] run return 0am Anfang einer Funktion überspringt den Rest für Objekte ohne das Etikett. - Wiederverwendbare Prüfungen: Eine Funktion, die 1 oder 0 zurückgibt, lässt sich mit /execute aus jeder anderen Funktion oder jedem Befehlsblock testen.
- Solche Abbruchzeilen halten Tick-Funktionen sparsam: Hör auf, sobald nichts zu tun ist.
✓ Geprüft in der Java Edition 26.3 · aktualisiert am 2. November 2026
/return: FAQ
Kann /return eine Kommazahl zurückgeben?
Nein, der Wert ist eine ganze Zahl. Multipliziere ihn vorher, etwa mit 100, wenn du Nachkommastellen brauchst.
Was passiert mit den Befehlen nach /return?
Sie werden übersprungen. Die Funktion endet in der Zeile mit /return, setz sie also dorthin, wo die Arbeit erledigt ist oder eine Prüfung scheitert.
Wie benutze ich /return?
Gib ihn mit aktivierten Cheats im Chat ein: /return fail.
Wer kann /return benutzen?
Cheats an oder Operator Stufe 2.
Seit wann gibt es /return?
Er steht seit der Java Edition 1.20 im offiziellen Befehlsbaum.