Comando
/function
Ejecuta una función de un paquete de datos, o todas las funciones de una etiqueta de funciones.
Sintaxis
| /function <name> |
| /function <name> <arguments> |
| /function <name> with (block <source>|entity <source>|storage <source>) [<path>] |
Argumentos
| Argumento | Tipo de valor | Qué escribir |
|---|---|---|
| <name> | Función | La ID de la función, por ejemplo my_pack:setup, o una etiqueta de función que empieza por #. |
| <arguments> | Datos entre llaves | Los valores de la macro como compuesto de datos, por ejemplo {name:"Alex"}. |
| <source> | Posición de bloque | Con with: la posición de bloque, la entidad única o el id de almacenamiento de donde se leen los valores de macro. |
| <path> | Ruta de datos | Con with: la ruta de datos del compuesto que contiene los valores de macro. Opcional. |
Detalles
| Nivel de permiso | 2: operadores, mundos con trucos activados, bloques de comandos y funciones |
| Funciona en | Administradores en servidores multijugador, mundos de un jugador con trucos activados, bloques de comandos y funciones. |
| Resultado | Informa «Ejecutando función» con el id de la función. Si una función devuelve un valor, también informa de «Función ... ha devuelto ...», y ese valor es el número que guarda /execute store. Cuando varias funciones de una etiqueta devuelven valores, el resultado es su suma. |
| Etiquetas de función | Un nombre que empieza por # ejecuta todas las funciones de esa etiqueta de función. Si la etiqueta no contiene funciones, el comando falla con «No se encontró ninguna función». |
| Argumentos para macros | Las funciones con líneas de macro necesitan valores. Escríbelos como un compuesto de datos tras el nombre, o léelos de un bloque, una entidad o un almacén con el subcomando with. |
| with | with block, with entity y with storage toman los valores de datos existentes. Una ruta opcional elige una parte de esos datos, que debe ser un compuesto; de lo contrario, el comando falla con «Se esperaba un compuesto». |
| Permiso dentro de funciones | Los comandos dentro de la función se ejecutan como máximo con el nivel de permisos 2, aunque la función la inicie alguien con un nivel superior, y no muestran su propia salida. |
| Valores que faltan | Si falta un valor de macro o una línea de macro se convierte en un comando no válido, el comando falla con «No se pudo instanciar la función». |
Ejemplos
/function my_pack:setupEjecuta la función setup del espacio de nombres my_pack del paquete de datos.
/function #my_pack:start_roundEjecuta todas las funciones de la etiqueta de funciones start_round.
/function my_pack:greet {name:"Alex"}Ejecuta la función greet y rellena su valor de macro name con Alex.
/function my_pack:greet with storage my_pack:settings greetingEjecuta la función greet con los valores de macro almacenados en greeting dentro del almacenamiento my_pack:settings.