Funções (Edição Bedrock)

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>

tick.json

O arquivo tick.json também está localizado na pasta behavior_packs/[behavior_pack]/functions, especificando funções a serem executadas em cada tick do jogo. As funções em execução neste arquivo são executadas pelo servidor na origem 0, 0, 0 no mundo superior. As funções neste arquivo são executadas assim que o mundo é inicializado, independentemente de o jogador ter sido carregado ou não.

• O objeto raiz.
  •  values: Uma lista de funções.
    • : Uma função.

Histórico

[ocultar]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.