Minecraft Wiki
Advertisement

Executa comandos encontrados no arquivo de função correspondente.

Na Edição Java, executa uma função ou todas as funções em uma tag de um datapack.
Na Edição Bedrock, executa uma função de um pacote de complementos.

Sintaxe[]

  • Edição Java
function <name>
  • Edição Bedrock
function <name: filepath>

Argumentos[]

EJ<name>: function
EB: name: filepath: CommandFilePath

Na Edição Java, deve ser um ID de espaço de nome, que se refere a uma única função ou prefixada com um #, que se refere a uma função de tag. Na Edição Bedrock, must be of the format path/to/function/file, which refers to a function located at [behavior_pack]/functions/path/to/function/file.mcfunction.

Resultado[]

ComandoGatilhoEdição JavaEdição Bedrock
qualqueros argumentos não são especificados corretamente não analisável falha
se as funções/tags de função especificadas não existem falham
sucesso Executa a(s) função(ões) por meio do executor do comando que executou o comando /function.

Saída[]

ComandoEdiçãoSituaçãoContagem de sucesso/execute store succeess .../execute store result ...
qualquerEdição JavaAo falhar000
On successa soma do número de todos os comandos executados na(s) função(ões) mais 1 (este comando em si)1o número de comandos executados (com êxito ou não) mais o número de funções incorporadas chamadas por uma função.
Edição BedrockAo falhar0N/AN/A
Ao sucesso1N/AN/A

Na Edição Java:[1][2]

A contagem de sucesso é a soma das contagens de sucesso de todos os comandos executados na função/funções mais 1 (este comando em si).
Por exemplo,
foo:bar1
function foo:bar2
foo:bar2
function foo:bar3
foo:bar3
say oi
A contagem de sucesso de /function foo:bar3 é 1 (um comando em foo:bar3) + 1 (este comando em si) = 2.
A contagem de sucesso de /function foo:bar2 é 2 (de cima) + 1 (este comando em si) = 3.
A contagem de sucesso de /function foo:bar1 é 3 (de cima) + 1 (este comando em si) = 4.
A mensagem de saída exibida no chat retorna o número de comandos executados (não o número de comandos bem-sucedidos) mais o número de funções incorporadas chamadas por uma função.
A contagem de saída do bate-papo de /function foo:bar3 é 1(um comando em foo:bar3).
A contagem de saída do bate-papo de /function foo:bar2 é 1 (um comando em foo:bar2) + 1 (um comando em foo:bar3) + 1 (uma função embutida ) = 3.
A contagem de saída do bate-papo de /function foo:bar1 é 1 (um comando em foo:bar1) + 1 (um comando em foo:bar2) + 1 (um comando em foo:bar3) + 2 (duas funções embutidas) = 5.
Se for bem sucedido, /execute store success sempre retorna 1. No entando, retorna 0.
Se for bem-sucedido, o valor de retorno de /execute store result é o mesmo que a contagem de saída do chat. Caso contrário, retorna 0.

Exemplos[]

  • Na Edição Java:
    • Para executar uma função localizada em data/custom/functions/example/test.mcfunction num pacote de dados carregado: /function custom:example/test
    • Para executar todas as funções em uma tag de função localizada em data/custom/tags/functions/example/test.json: /function #custom:example/test
    • Para executar uma função se houver uma ovelha dentro de um raio de 2 blocos: /execute if entity @e[type=sheep,distance=..2] run function custom:example/test
    • Para executar uma função, a menos que o executor seja um jogador: /execute unless entity @s[type=player] run function custom:example/test

História[]

Edição Java
1.12 pre1 Adicionado /function.
1.13 17w49b /function agora aceita tags como argumento.
Removido argumentos [if/unless] em favor de /execute [if/unless].
Edição Bedrock
1.8.0 beta 1.8.0.8 Adicionado /function.

Veja Também[]

  • /tag – Para executar a função em lote, a cada tique ou no recarregamento do servidor.

Referências[]

Advertisement