Commande
/function
Exécute une fonction d'un pack de données, ou toutes les fonctions d'une étiquette de fonctions.
Syntaxe
| /function <name> |
| /function <name> <arguments> |
| /function <name> with (block <source>|entity <source>|storage <source>) [<path>] |
Arguments
| Argument | Type de valeur | Quoi saisir |
|---|---|---|
| <name> | Fonction | L’ID de la fonction, par exemple my_pack:setup, ou une balise de fonction commençant par #. |
| <arguments> | Données entre accolades | Les valeurs de la macro sous forme de composé de données, par exemple {name:"Alex"}. |
| <source> | Position de bloc | Pour with : la position de bloc, l'entité unique ou l'identifiant de stockage où sont lues les valeurs de macro. |
| <path> | Chemin de données | Pour with : le chemin de données du composé qui contient les valeurs de macro. Facultatif. |
Détails
| Niveau de permission | 2 : opérateurs, mondes avec triche activée, blocs de commande et fonctions |
| Fonctionne dans | Opérateurs sur les serveurs multijoueur, mondes solo avec triche activée, blocs de commande et fonctions. |
| Résultat | Indique « Exécution de la fonction » avec l'identifiant de la fonction. Si une fonction renvoie une valeur, elle indique aussi « Fonction ... a renvoyé ... », et cette valeur est le nombre que /execute store enregistre. Quand plusieurs fonctions d'une balise renvoient des valeurs, le résultat est leur somme. |
| Tags de fonction | Un nom commençant par # exécute toutes les fonctions de ce tag de fonction. Si le tag ne contient aucune fonction, la commande échoue avec « Aucune fonction trouvée ». |
| Arguments pour les macros | Les fonctions qui contiennent des lignes de macro ont besoin de valeurs. Écrivez-les sous forme de composé de données après le nom, ou lisez-les depuis un bloc, une entité ou un stockage avec la sous-commande with. |
| with | with block, with entity et with storage prennent les valeurs dans des données existantes. Un chemin facultatif choisit une partie de ces données, qui doit être un composé ; sinon la commande échoue avec « Composé attendu ». |
| Permission dans les fonctions | Les commandes à l'intérieur de la fonction s'exécutent au plus avec le niveau de permission 2, même si la fonction est lancée par quelqu'un ayant un niveau supérieur, et elles n'affichent pas leur propre sortie. |
| Valeurs manquantes | Si une valeur de macro manque ou si une ligne de macro devient une commande invalide, la commande échoue avec « Impossible d'instancier la fonction ». |
Exemples
/function my_pack:setupExécute la fonction setup de l'espace de noms my_pack du pack de données.
/function #my_pack:start_roundExécute toutes les fonctions de l'étiquette de fonctions start_round.
/function my_pack:greet {name:"Alex"}Exécute la fonction greet et remplit sa valeur de macro name avec Alex.
/function my_pack:greet with storage my_pack:settings greetingExécute la fonction greet avec les valeurs de macro stockées sous greeting dans le stockage my_pack:settings.