Funções permite que os jogadores executem listas de comandos usando arquivos de texto com a extensão .mcfunction
. Esta página cobre como usar as funções na Edição Bedrock.
Uso[]
Os arquivos de texto devem ser colocados em uma pasta de nível superior chamada "funções" dentro de um pacote de comportamento, localizados em com.mojang/behavior_packs/[behavior_pack]/functions.
Subpastas e namespaces[]
Subpastas podem ser adicionadas a esta pasta para servir como namespaces.
Por exemplo, executar a função sub/foo
executa o arquivo localizado em [behavior_pack]/functions/sub/foo.mcfunction.
/reload
[]
Nota: Atualmente, o /reload
recarrega apenas as funções que já existem no momento em que o jogo é iniciado, o que significa que alterações podem ser feitas nas funções existentes, mas o jogo deve ser reiniciado para funções recém-adicionadas.
Resultados de sucesso[]
Ao executar uma função com sucesso, uma mensagem é exibida no chat: "Executado [amount] Comando(s) da função [function file directory]." Na versão 1.12.0, isso é "[amount] entradas de função executadas com sucesso."
Sintaxe da função[]
Dentro do arquivo .mcfunction
, um comando válido é colocado por linha, sem a barra usual /
. Os jogadores podem adicionar comentários no arquivo de texto da função precedendo-os com um #
.
min_engine_version
[]
As funções requerem uma versão mínima do mecanismo especificada no arquivo pack manifest.json
.
Este campo determina qual versão de um comando será executada. O número especificado aqui deve corresponder ao número da versão do jogo. Por exemplo, digamos que /fill
foi alterado em 1.9.0
. Se o pacote de comportamento tiver "min_engine_version": [1, 8, 0]
e executar uma função que contém /fill
, ele executará a versão mais antiga de fill (como se a versão fosse ainda 1.8.0
).
Exemplo de manifesto[]
{ "format_version": 1, "header": { "description": "Function worldedit", "name": "Function worldedit", "uuid": "11111111-1111-1111-1111-111111111111", "version": [1, 11, 3], "min_engine_version": [1, 11, 3] }, "modules": [ { "description": "", "type": "data", "uuid": "22222222-2222-2222-2222-222222222222", "version": [1, 11, 3] } ] }
Exemplo de função simples[]
title @p title Test setblock ~ ~2 ~ diamond_ore say Test #this is a comment
Exemplo de função mais complexa[]
Esta função constrói uma casa básica de pedra e madeira ao redor do executor. Observe que, como a função executa os comandos em ordem, as janelas de vidro e a porta de madeira substituem as paredes de pedra criadas pelo primeiro comando.
fill ~-2 ~-1 ~-2 ~2 ~2 ~2 stonebrick 0 hollow fill ~-2 ~-1 ~-2 ~2 ~-1 ~2 planks fill ~ ~ ~2 ~ ~ ~2 wooden_door 1 fill ~-2 ~1 ~ ~-2 ~1 ~ glass fill ~2 ~1 ~ ~2 ~1 ~ glass fill ~ ~1 ~-2 ~ ~1 ~-2 glass
Executando uma função[]
As funções tentam executar todos os comandos em um único tick, incluindo os comandos de funções aninhadas chamadas dentro de outra função.
Limites[]
Uma única chamada de função executa até 10.000 comandos (incluindo chamadas para outras funções, ou seja, recursão).
Comandos[]
/function
[]
- Permite que os jogadores executem uma função uma vez
- Os comandos na função são executados por meio da entidade ou bloco de comando que executou o comando
/function
. - Uso:
/function <path/to/function/file>
Histórico[]
Edição Bedrock | |||||
---|---|---|---|---|---|
1.8.0 | beta 1.8.0.8 | Os arquivos de função foram adicionados. | |||
Os arquivos de função estão disponíveis apenas em pacotes de comportamento. | |||||
1.13.0 | beta 1.13.0.1 | Os arquivos de função agora estão visíveis na lista de comandos. |
Edições |
| ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Desenvolvimento |
| ||||||||||
Técnico |
| ||||||||||
Multijogador | |||||||||||
Características exclusivas |
| ||||||||||
Removido |
|