Comandos/function

function

Visibilidade	Visível
Restrições	Nenhuma

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

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

Na Edição Java, must be a namespaced ID, which refers to a single function, or one prefixed with a #, which refers to a function 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

Comando	Gatilho	Edição Java	Edição Bedrock
qualquer	os 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

Comando	Edição	Situação	Contagem de sucesso	/execute store succeess ...	/execute store result ...
qualquer	Edição Java	Ao falhar	0	0	0
		On success	a soma do número de todos os comandos executados na(s) função(ões) mais 1 (este comando em si)	1	o 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 Bedrock	Ao falhar	0	N/A	N/A
		Ao sucesso	1	N/A	N/A

Na Edição Java:

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 é 1 (um comando em foo:bar3) + 1 (este comando em si) = 2.

A contagem de sucesso de é 2 (de cima) + 1 (este comando em si) = 3.

A contagem de sucesso de é 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 é 1(um comando em foo:bar3).

A contagem de saída do bate-papo de é 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 é 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, sempre retorna 1. No entando, retorna 0.

Se for bem-sucedido, o valor de retorno de é 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:
  • Para executar todas as funções em uma tag de função localizada em data/custom/tags/functions/example/test.json:
  • 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 /.
1.13		17w49b			/ 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 /.

Veja Também

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

Referências

Comandos

Ver em: Template:Comandos/content [editar]