función
Nivel de permiso son requeridos |
2 [solo JE] |
---|---|
Restricciones |
Solo trampa [solo BE] |
Ejecuta los comandos que se encuentran en el archivo de función correspondiente.
En Java Edition, ejecuta una función o todas las funciones en una etiqueta de un paquete de datos.
En Bedrock Edition, ejecuta una función de un paquete de comportamiento.
Contenido
- 1 Sintaxis
- 2 Argumentos
- 3 Resultado
- salida 4
- 5 Ejemplos
- Historia de 6
- 7
- 8
Sintaxis
- Edición Java
- Edición Bedrock
Argumentos
USTED: : función
BE: nombre: ruta de archivo: CommandFilePath
Resultado
Comando | Desencadenar | Edición Java | Edición Bedrock |
---|---|---|---|
cualquier | los argumentos no están especificados correctamente | Insuperable | Fallidos |
las funciones o etiquetas de función especificadas no existen | Fallidos | ||
Sobre el éxito | Ejecuta la (s) función (es) a través del ejecutor de comando que ejecutó el comando / function. |
Salida
Comando | Edición | Situación | Recuento de éxitos | / ejecutar el éxito de la tienda ... | / ejecutar el resultado de la tienda ... |
---|---|---|---|---|---|
cualquier | Edición Java | Al fallar | 0 | 0 | 0 |
En caso de éxito cuando no es ejecutado por una función | el número de todos los comandos ejecutados en las funciones y también 1 (este comando en sí) | 1 | el número de comandos ejecutados (con éxito o no) y también el número de funciones integradas. | ||
En caso de éxito cuando se ejecuta en una función | N/A | 1 | 0 | ||
Edición Bedrock | Al fallar | 0 | N/A | N/A | |
Sobre el éxito | 1 | N/A | N/A |
En Java Edition: [1] [2]
El recuento de éxitos es la suma de los recuentos de éxitos de todos los comandos ejecutados en la función / funciones más 1 (este comando en sí). Por ejemplo, foo: bar1 función foo: bar2 foo: bar2 función foo: bar3 foo: bar3 say hola El recuento de éxitos de / function foo: bar3 es 1 (un comando en foo: bar3) + 1 (este comando en sí) = 2. El recuento de éxitos de / function foo: bar2 es 2 (desde arriba) + 1 (este comando en sí) = 3. El recuento de éxito de / function foo: bar1 es 3 (desde arriba) + 1 (este comando en sí) = 4. El mensaje de salida que se muestra en el chat devuelve el número de comandos ejecutados (no el número de comandos que se ejecutaron correctamente ) más el número de funciones integradas llamadas por una función. El recuento de salida de chat de / function foo: bar3 es 1 (un comando en foo: bar3). El recuento de salida de chat de / function foo: bar2 es 1 (un comando en foo: bar2) + 1 (un comando en foo: bar3) + 1 (una función incorporada) = 3. El recuento de salida de chat de / function foo: bar1 es 1 (un comando en foo: bar1) + 1 (un comando en foo: bar2) + 1 (un comando en foo: bar3) + 2 (dos funciones integradas) = 5. Si tiene éxito, / execute store success siempre devuelve 1 De lo contrario, devuelve 0. Si tiene éxito, el valor de retorno de / ejecutar el resultado de la tienda es el mismo que el recuento de salida del chat. De lo contrario, devuelve 0.
Ejemplos
- En Java Edition:
- Para ejecutar una función ubicada en data / custom / functions / example / test.mcfunction en un paquete de datos cargado: / function custom: example / test
- Para ejecutar todas las funciones en una etiqueta de función ubicada en data / custom / tags / functions / example / test.json: / function #custom: example / test
- Para ejecutar una función si hay una oveja dentro de un radio de 2 bloques: / ejecutar si entidad @e [tipo = oveja, distancia = .. 2] ejecutar función personalizada: ejemplo / prueba
- Para ejecutar una función a menos que el ejecutor sea un jugador: / ejecutar a menos que la entidad @s [tipo = jugador] ejecute la función personalizada: ejemplo / prueba
Historia
Edición Java | |||||
---|---|---|---|---|---|
1.12 | pre1 | Agregado / función. | |||
1.13 | 17w49b | / function ahora acepta etiquetas de función como argumento. | |||
Se eliminaron los argumentos [si / a menos que] a favor de / ejecutar [si / a menos que]. | |||||
Edición Bedrock | |||||
1.8.0 | beta 1.8.0.8 | Agregado / función. |
- / tag: para ejecutar la función por lotes, cada tick o en el servidor (re) cargar.
- ↑ MC-148612
- ↑ MC-135636
Comandos
Ver en: Plantilla: Comandos / contenido [editar]