Función (Bedrock Edition)

Para el comando, consulte Comandos / función. : Función (Edición Java) Se ha sugerido que esta página se mueva a las funciones de Bedrock Edition.
Si este movimiento afecta a muchas páginas o puede ser potencialmente controvertido, no mueva la página hasta que se logre un consenso. [discutir] Razón: Coherencia con otros artículos que tienen una variante de Java y base; el plural debería ser discutido
Cuando se mueva, asegúrese de utilizar la herramienta adecuada en lugar de simplemente copiar y pegar el contenido de la página, para preservar el historial de ediciones. Esta característica es exclusiva de Bedrock Edition. 

Las funciones clave Permitir a los jugadores ejecutar listas de comandos usando archivos de texto con la extensión .mcfunction. Esta página cubre cómo usar las funciones en Bedrock Edition.

Contenido

• Uso de 1
  • 1.1 Subcarpetas y espacio de nombres
  • 1.2 / recarga
  • 1.3 Resultados de éxito
• 2 sintaxis de funciones
  • 2.1 min_engine_version
    • 2.1.1 Ejemplo de manifiesto
    • 2.1.2 Ejemplo de función simple
    • 2.1.3 Ejemplo de función más compleja
• 3 Ejecutando una función
  • 3.1 Límites
  • 3.2 comandos
    • 3.2.1 / función
• Historia de 4

Uso

Los archivos de texto deben colocarse en una carpeta de nivel superior llamada "funciones" dentro de un paquete de comportamiento, ubicado en com.mojang / behavior_packs / [behaviour_pack] / functions.

Subcarpetas y espacio de nombres

Se pueden agregar subcarpetas a esta carpeta para que sirvan como espacios de nombres.

Por ejemplo, al ejecutar la función sub / foo se ejecuta el archivo ubicado en [behavior_pack] /functions/sub/foo.mcfunction.

/recargar

Nota: Actualmente / reload recarga solo las funciones que ya existen en el momento en que se inicia el juego, lo que significa que se pueden realizar cambios en las funciones existentes, pero el juego debe reiniciarse para las funciones recién agregadas.

Resultados exitosos

Al ejecutar con éxito una función, aparece un mensaje en el chat: "Ejecutado [cantidad] Comando (s) de la función [directorio de archivos de función]". En la versión 1.12.0, esto es "Entradas de función [cantidad] ejecutadas con éxito".

Sintaxis de la función

Dentro del archivo .mcfunction, se coloca un comando válido por línea, sin la barra diagonal habitual /. Los jugadores pueden agregar comentarios dentro del archivo de texto de la función precediéndolos con un #.

min_engine_version

Las funciones requieren una versión mínima del motor especificada en el archivo pack manifest.json.

Este campo determina qué versión de un comando ejecutar. El número especificado aquí debe coincidir con el número de versión del juego. Por ejemplo, digamos que / fill se cambió en 1.9.0. Si su paquete de comportamiento tiene "min_engine_version": [1, 8, 0] y ejecuta una función que contiene / fill, ejecuta la versión anterior de fill (como si la versión todavía fuera 1.8.0).

Ejemplo manifiesto

{"format_version": 1, "header": {"description": "Función worldedit", "nombre": "Función worldedit", "uuid": "11111111-1111-1111-1111-111111111111", "versión": [1, 11, 3], "min_engine_version": [1, 11, 3]}, "modules": [{"description": "", "type": "data", "uuid": "22222222-2222 -2222-2222-222222222222 "," versión ": [1, 11, 3]}]}

Ejemplo de función simple

title @p title Test setblock ~ ~ 2 ~ diamond_ore say Test # esto es un comentario

Ejemplo de función más compleja

Esta función construye una casa básica de piedra y madera alrededor del albacea. Tenga en cuenta que debido a que la función ejecuta los comandos en orden, las ventanas de vidrio y la puerta de madera reemplazan las paredes de piedra creadas por el primer comando.

relleno ~ -2 ~ -1 ~ -2 ~ 2 ~ 2 ~ 2 ladrillo de piedra 0 relleno hueco ~ -2 ~ -1 ~ -2 ~ 2 ~ -1 ~ 2 tablones relleno ~ ~ ~ 2 ~ ~ ~ 2 puerta_de_madera 1 relleno ~ -2 ~ 1 ~ ~ -2 ~ 1 ~ relleno de vidrio ~ 2 ~ 1 ~ ~ 2 ~ 1 ~ relleno de vidrio ~ ~ 1 ~ -2 ~ ~ 1 ~ -2 vidrio

Ejecutando una función

Las funciones intentan ejecutar todos los comandos dentro de un solo tick, incluidos los comandos de funciones anidadas llamadas dentro de otra función.

Límites

Una sola llamada de función ejecuta hasta 10,000 comandos (incluidas las llamadas a otras funciones, es decir, recursividad).

Comandos

/función

• Permite a los jugadores ejecutar una función una vez.
• Los comandos de la función se ejecutan a través de la entidad o el bloque de comandos que ejecutó el comando / function.
• Uso: / función

Historia