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 formatpath/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 |
- 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.
- foo:bar1
- 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.
- A contagem de saída do bate-papo de
- 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
- Para executar uma função localizada em
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.