Comandos/function

{
    "title": "<code>/function</code>",
    "rows": [
        {
            "field": "",
            "label": "(link to Nível de permissão article, displayed as Nível de permissão<br />exigido)"
        },
        {
            "field": "Nenhuma",
            "label": "(link to Comandos#Restrições article, displayed as Restrições)"
        }
    ],
    "invimages": [],
    "images": []
}

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[editar | editar código-fonte]

• Edição Java

function <name>

• Edição Bedrock

function <name: filepath>

Argumentos[editar | editar código-fonte]

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 marcação. Na Edição Bedrock, deve estar no formato path/to/function/file, que se refere a uma função localizada em [behavior_pack]/functions/path/to/function/file.mcfunction.

Resultado[editar | editar código-fonte]

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[editar | editar código-fonte]

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:^[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[editar | editar código-fonte]

• 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[editar | editar código-fonte]

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[editar | editar código-fonte]

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

Referências[editar | editar código-fonte]

Navegação[editar | editar código-fonte]

v t e Comandos
Todas as edições	clear clone damage deop difficulty effect enchant execute fill function gamemode gamerule give help kick kill list locate loot me msg op particle playsound reload ride say scoreboard setblock setworldspawn spawnpoint spreadplayers stopsound summon tag teleport tell tellraw time title tp w weather xp Removidos placefeature Apenas Edição Java advancement attribute ban ban-ip banlist bossbar data datapack debug defaultgamemode experience fillbiome forceload item jfr pardon pardon-ip place publish random return save-all save-off save-on seed setidletimeout spectate team teammsg tm tick trigger worldborder whitelist Em breve rotate Removidos achievement banip blockdata broadcast chunk entitydata home iron locatebiome replaceitem setspawn solid stats testfor testforblock testforblocks toggledownfall unban warden_spawn_tracker wood Apenas EJ & EB recipe schedule stop Apenas Edição Bedrock allowlist camera camerashake changesetting clearspawnpoint dedicatedwsserver event fog inputpermission music playanimation project querytarget reloadconfig replace save script scriptevent simulationtype structure volumearea whitelist Removidos detect mixer resupply Apenas Edição Education classroommode closechat code codebuilder lesson videostream Removidos position videostreamaction Apenas EB & EE ? ability allowlist alwaysday codebuilder_actorinfo connect daylock dialogue enableencryption getlocalplayername gettopsolidblock immutableworld listd mobevent ops permission replaceitem setmaxplayers takepicture testfor testforblock testforblocks tickingarea titleraw toggledownfall wb worldbuilder wsserver Removidos clearfixedinv executeasself place setfixedinvslot setfixedinvslots transferserver
Recursos de piada	Apenas Edição Java debugdim transform vote warp