Ver el código de «Función (Java Edition)»

{{Para|el comando|Comandos/function}}
{{véase también|Función (Bedrock Edition)}}
{{exclusivo|java}}
Las '''Funciones''' permite a los jugadores hacer correr listas de [[comandos]] usando archivos de texto con la extensión <code>.mcfunction</code>. Se recomienda utilizar codificación ANSI (sin BOM) para los archivos de funciones para prevenir cualquier problema. Esta página cubre cómo utilizar las funciones en ''Java Edition''.

== Uso ==
Para utilizar funciones, un archivo de texto <code>[FUNCTION_NAME].mcfunction</code> deberá ser colocado en la carpeta <code>[WORLD_NAME]/datapacks/[DATA_PACK_NAME]/data/[NAMESPACE]/functions</code>. Para ejecutar la función, utilice el nombre de función completo, que es <code>[NAMESPACE]:[FUNCTION_NAME]</code>. Si no hay ambigüedad con otros paquetes de datos o con un comando de Minecraft existente, puedes usar <code>[FUNCTION_NAME]</code>. Si el espacio de nombres se omite al intentar llamar a una función, se establecerá de manera predeterminada en el espacio de nombres <code>minecraft:</code>. Se recomienda usar un espacio de nombres personalizado para evitar un comportamiento no deseado en el caso de futuras adiciones al espacio de nombres predeterminado.<ref>{{tweet|dinnerbone|877427768715341824|Until vanilla adds something with the same name, then it won't work for you! Or if someone else has to work with your stuff, then confusing!|21 de junio de 2017}}</ref>

Las funciones también se pueden colocar en subcarpetas dentro de la carpeta <code>functions</code>. También es necesario tener un archivo [[Paquete de datos|pack.mcmeta]] en la carpeta [DATA_PACK_NAME]. Por ejemplo, ejecutar la función <code>custom:example/test</code> hará referencia al archivo ubicado en <code>data/custom/functions/example/test.mcfunction</code>.

Las funciones, al ser archivos de texto, son fácilmente modificables y es menos probable que los [[bloques de comandos]] induzcan retrasos cuando se usan en grandes cantidades. Si se modifica o agrega una función, usar el comando {{Comando|reload}} recargará los archivos de función desde el disco. Esto permite que ''Minecraft'' reconozca cualquier cambio en los archivos de funciones, sin necesidad de salir y volver a entrar al mundo.

Upon successfully running {{Comando|function}}, a message will display in the [[chat]]: ''Executed [amount] command(s) from function '[function file directory]'''. Embedded functions won't display this chat messsage. The successful output of the commands inside a function cannot be measured with a [[comparator]] (although the same effect could be accomplished with the use of {{Comando|execute store}} command).

In a singleplayer or a LAN world, like a [[command block]], a function can run any command that is no more restrictive than permission level 2.

On the default multiplayer software, a function can run any command that is no more restrictive than the permission level prescribed in [[Server.properties#function-permission-level|<code>function-permission-level</code>]] setting in <samp>server.properties</samp>.

=== Sintaxis de la función ===
[[File:TestingFunctions.png|thumb|right|250px|Probando el sistema de funciones. En esta función simple se utilizaron tres mensajes {{Comando|tellraw}} y un comando {{Comando|give}}.]]

Dentro del archivo <code>.mcfunction</code>, se coloca un comando válido por línea, sin la barra inclinada habitual (<code>/</code>). Los jugadores pueden agregar comentarios dentro del archivo de texto de función comenzando una línea con <code>#</code>.

Los comandos individuales en las funciones pueden tener más de 32 500 caracteres como límite en los bloques de comandos, pero la cantidad total de comandos que se ejecutan dentro de una función seguirá obedeciendo a {{Comando|gamerule maxCommandChainLength}}, que es 65 536 comandos de forma predeterminada; cualquier comando más allá de este límite será ignorado.

=== Ejecutando una función ===
Las funciones ejecutarán todos sus comandos en un solo [[tick]] y las funciones llamadas desde dentro de otras funciones también ejecutarán sus comandos en el mismo tick que su padre. Las funciones utilizarán el entorno de comandos de lo que sea que haya llamado a la función. Esto incluye el remitente del comando, la posición, la rotación, etc. Este contexto de comando se conserva para todos los comandos de la función, por lo que un comando {{Comando|setblock}} utilizará el contexto de posición guardado incluso cuando un comando anterior en la misma función se teletransportó el albacea original a una posición diferente. Por ejemplo:

 execute as @a at @s run function foo:bar

''foo:bar''
 teleport @s ~ ~5 ~
 setblock ~ ~-1 ~ emerald_block
 execute at @s run setblock ~ ~-1 ~ diamond_block

Cuando se llama a través de un jugador, esta función teletransportará a ese jugador 5 bloques hacia arriba, colocará un [[bloque de esmeralda]] un bloque debajo de su posición original ''antes'' del teletransporte, y colocará un [[bloque de diamante]] un bloque debajo de su nueva posición ''después'' del teletransporte.

Como se ve en el ejemplo anterior, el contexto del comando se puede actualizar como de costumbre mediante sus respectivos subcomandos {{Comando|execute}}.

Se sugiere usar el [[Comando#Variables del selector de destino|{{Código|@s}} seleccionador de objetivos]] para la [[entidad]] más utilizada en una función y usar {{Comando|execute}} como al llamar esa función para modificar la entidad ejecutora a la entidad más utilizada. Esto puede simplificar el contenido si la entidad se seleccionó con [[Commands#Target selector arguments|argumentos del selector de destino]] y mejorar el rendimiento en general para la iteración reducida a través de la lista de entidades mundiales.

Hay varios métodos para ejecutar un archivo de función en el juego:

==== Commands ====
;{{Comando|function}}
* Permite a los jugadores ejecutar una función o todas las funciones en una [[Etiqueta#Etiquetas de función|etiqueta de función]] una vez.
* Utiliza el entorno de comandos de lo que sea que se llame el comando {{Comando|function|link=none}}.
* El entorno de comando inicial puede ser modificado por el comando {{Comando|execute}}.
* Usage: {{Comando|function|...}}

==== Progresos ====
Los [[progresos]] pueden ejecutar una función una vez como recompensa por completarlos. Los comandos en la función se ejecutan a través del jugador que completó el avance.

Las funciones de recompensa se llaman dentro de los archivos de avance [[JSON]] usando el siguiente formato:

 {
     "rewards": {
         "function": "namespace:path/to/function/file"
     }
 }

==== Etiquetas ====
Las funciones se pueden agrupar usando [[etiqueta]]s en [[Paquete de datos|paquetes de datos]]. Estas etiquetas se pueden llamar para ejecutar todas las funciones dentro de esa etiqueta con {{Comando|function #''(namespace)'':''(tag)''}}.

Las funciones etiquetadas en <code>tick</code> ejecutarán automáticamente cada tick al comienzo del tick. Las funciones etiquetadas en <code>load</code> se ejecutarán después de (re)cargar el paquete de datos.

*Nota: <code>tick</code> se ejecutará antes de <code>load</code> después de volver a cargar el paquete de datos. Esto significa que no puede confiar inherentemente en un estado estable del paquete de datos para el primer tic.

== Historial ==
{{Historial|java}}
{{Historial||1.12|snap=pre1|Funciones añadidas.}}
{{Historial|||snap=pre3|Ya no se permite que los comandos comiencen con / (barra inclinada)|Los comentarios ahora solo pueden ir precedidos de #; usar // ya no está permitido}}
{{Historial|||snap=pre4|Se agregaron nuevos argumentos al comando {{Comando|function}}: <code>[if{{!}}unless] [selector]</code>}}
{{Historial|||snap=pre6|Las funciones omitidas (cuando falla un condicional) ahora se consideran fallas cuando se usan en los comandos.}}
{{Historial||1.13|snap=17w43a|Las funciones personalizadas se han movido a paquetes de datos.}}
{{Historial|||snap=17w45a|Las funciones ahora se analizan por completo y se almacenan en caché durante la carga.}}
{{Historial|||snap=17w49b|Se eliminó {{Comando|gamerule|gameLoopFunction}}.|La función ahora se puede etiquetar.|Las funciones etiquetadas en <code>tick</code> ahora ejecutan cada tick al comienzo del tick .}}
{{Historial|||snap=18w01a|Las funciones etiquetadas en <code>load</code> ahora se ejecutan después de (re)cargar el paquete de datos.}}
{{Historial||1.14.4|snap=pre4|Se agregó <code>function-permission-level</code> a [[server.properties]]}}
{{Historial|foot}}

== Problemas ==
{{Lista de problemas|Function}}

== Referencias ==
{{Lista de referencias}}

{{Java Edition}}

[[de:Funktion]]
[[en:Function (Java Edition)]]
[[fr:Fonction]]
[[ja:関数 (Java Edition)]]
[[pl:Funkcja]]
[[pt:Funções]]
[[ru:Функция]]
[[uk:Функція]]
[[zh:函数（Java版）]]