Restituire un valore
/return 1Termina subito la funzione e restituisce 1. Scrivilo in un file .mcfunction senza la barra.
/return comando in Minecraft
/return interrompe la funzione in corso e restituisce un valore al comando che l'ha chiamata. /return fail fa invece fallire la chiamata, e /return run restituisce il risultato di un altro comando. Così le funzioni diventano verifiche riutilizzabili per /execute if function e /execute store.
Sintassi
/return fail/return run …/return <value>| Argomento | Accetta | A cosa serve |
|---|---|---|
| value | Numero intero | Numero intero restituito a chi chiama; execute if function considera 0 una verifica fallita. |
Esempi
Far fallire la funzione
/return failTermina la funzione come fallita: execute if function non passa e store success salva 0.
Uscire subito dopo un controllo
/execute unless entity @s[tag=ready] run return 0All'inizio di una funzione la termina per ogni esecutore senza l'etichetta ready.
Usare una funzione come verifica
/execute if function mypack:has_key run say Porta sbloccataEsegue mypack:has_key e invia il messaggio solo se restituisce un valore diverso da 0.
Salvare il valore restituito
/execute store result score total calc run function mypack:count_mobsScrive il numero restituito da mypack:count_mobs nel nome fittizio total dell'obiettivo calc.
Componi il tuo comandoCompila i campi, poi copia il comando.
Generatore di comandiValori restituiti in pratica
Dentro una funzione, return 1 termina subito il file: le righe successive non vengono eseguite. Il valore va a chi ha chiamato la funzione. Scritto in chat, /function risponde «La funzione ... ha restituito 1». execute if function riesce quando il valore non è 0, e execute store result lo scrive in un punteggio di /scoreboard.
return fail termina la funzione come fallita: execute if function non riesce e store success salva 0. return run esegue un comando e ne restituisce il risultato, per esempio return run scoreboard players get @s coins per restituire un punteggio.
Schemi utili
- Uscita anticipata:
execute unless entity @s[tag=ready] run return 0all'inizio di una funzione salta il resto per le entità senza l'etichetta. - Verifiche riutilizzabili: una funzione che restituisce 1 o 0 si può testare con /execute da qualsiasi altra funzione o blocco comandi.
- Queste righe di controllo alleggeriscono le funzioni a ogni tick: fermati appena non c'è nulla da fare.
✓ Verificato nella Java Edition 26.3 · aggiornato il 2 novembre 2026
/return: FAQ
/return può restituire un numero decimale?
No, il valore è un numero intero. Se ti servono decimali, moltiplica prima il valore, per esempio per 100.
Cosa succede ai comandi dopo /return?
Vengono saltati. La funzione si ferma sulla riga di /return, quindi mettila dove il lavoro è finito o dove una verifica fallisce.
Come si usa /return?
Scrivilo in chat con i trucchi attivi: /return fail.
Chi può usare /return?
Trucchi attivi o operatore di livello 2.
Da quando esiste /return?
È nell'albero ufficiale dei comandi dalla Java Edition 1.20.