Minecraft:Function (Bedrock Edition)

Functions allow players to run lists of commands using text files with the extension .mcfunction. This page covers how to use functions in Template:Editions.

Usage

Text files must be placed into a top-level folder named "functions" within a Minecraft:behavior pack, located at Template:Mono. Subfolders can also be added to this folder. For example, running the function sub/foo runs the file located at Template:Mono.

===

1. REDIRECT Template:Command

Template:Redr === Note: Currently

1. REDIRECT Template:Command

Template:Redr reloads only functions that already exist at the time the game is launched, meaning changes can be made to existing functions but the game must be restarted for newly added functions.

Success results

Upon successfully running a function, a message displays in chat: "Successfully executed Template:Mono function entries."

Function syntax

Within the .mcfunction file, one valid command is placed per line, without the usual forward slash /. Players can add comments within the function text file by preceding them with a #.

===

1. REDIRECT Template:Code

Template:Redr === Functions require a minimum engine version specified in the pack

1. REDIRECT Template:Code

Template:Redr file.

This field determines which version of a command to run. The number specified here should match the version number of the game. For example,

1. REDIRECT Template:Command

Template:Redr was changed in 1.19.70. If your behavior pack has "min_engine_version": [1, 19, 10] and runs a function that contains

1. REDIRECT Template:Command

Template:Redr, it runs the older version of fill (as if the version was still 1.19.10).

Manifest example

A manifest is required for Add-Ons, behaviour packs and resource packs to work. Note that the three dots ... must be replaced with an actual UUID, which can be generated with a UUID generator like UUIDTools.com.

{
    "format_version": 3,
    "header": {
        "name": "House Building Add-On",
        "description": "Let the game build houses for you using this Add-On",
        "uuid": "...",
        "version": "1.0.0",
        "min_engine_version": "1.26.10"
    },
    "modules": [
        {
            "type": "data",
            "uuid": "...",
            "version": "1.0.0"
        }
    ],
    "metadata": {
        "authors": ["Minecraft Wiki"],
        "product_type": "addon"
    }
}

Simple function example

title @p title Test
setblock ~ ~2 ~ sulfur_bricks
say Test
#this is a comment

More complex function example

This function builds a basic house around the executor. Note that because the function runs commands in order, the Minecraft:glass windows and spruce door replace the walls created by the first command.

fill ~-2 ~-1 ~-2 ~2 ~2 ~2 stone_bricks 0 hollow
fill ~-2 ~-1 ~-2 ~2 ~-1 ~2 spruce_planks
fill ~ ~ ~2 ~ ~ ~2 spruce_door 1
fill ~-2 ~1 ~ ~-2 ~1 ~ glass
fill ~2 ~1 ~ ~2 ~1 ~ glass
fill ~ ~1 ~-2 ~ ~1 ~-2 glass

Running a function

Functions attempt to run all commands within a single tick, including the commands of nested functions called within another function.

Limits

A single function call runs up to 10,000 commands (including calls to other functions, i.e. recursion).

Commands

====

1. REDIRECT Template:Command

Template:Redr ====

• Allows players to run a function once.
• The commands in the function are run through the entity or command block that ran the /function command.
• Syntax: /function <path/to/function/file>

Command syntax

• Template:Nbt/sprite The root object.
  • Template:Nbt/sprite values: A list of functions.
    • Template:Nbt/sprite: A function.

tick.json

• The tick.json file is also located in the Template:Mono folder, specifying functions to be executed on every game tick. Functions running in this file are executed by the server at origin 0, 0, 0 in the overworld. Functions in this file are executed as soon as the world is initialized, regardless of whether or not the player has been loaded.

Navigation

Editions	Merged Template:Edition Template:Edition Ports to consoles Template:Wikipedia Template:Wikipedia Template:Wikipedia Template:Wikipedia Template:Wikipedia Discontinued Template:Edition Template:Edition Template:Edition
Development	Version history Template:LegacyBlockLink Template:EntityLink Template:FileLink Template:FileLink Template:EnvLink Template:ItemLink Template:BlockLink Template:InvLink Template:EntityLink Template:FileLink Template:EntityLink
Technical	Template:EffectLink Template:FileLink Template:FileLink Template:File com.mojang Template:FileLink Template:File Installation files Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:BlockLink Template:File Identifier Template:FileLink Template:ItemLink Template:EnvLink Template:EnvLink Anomalous Template:ItemLink Template:EnvLink § Formatting codes Simulation distance Template:BlockLink Template:FileLink Template:FileLink Template:EnvLink Template:FileLink Template:EntityLink Template:BlockLink Development resources Template:Nbt NBT format Template:Nbt Level format Template:EnvLink Protocol Template:EnvLink RakNet Creator Template:File Official documentation Template:FileLink Template:EntityLink Template:File File extensions Template:FileLink Add-ons Template:ItemLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:FileLink Template:EnvLink Template:EnvLink Template:BiomeLink Template:EnvLink Family Spawn event Template:ItemLink Template:BlockLink Template:EnvLink Template:BiomeLink Template:EnvLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink manifest.json Template:EnvLink Template:Nbt Molang Template:BlockLink
Multiplayer	Template:FileLink Featured servers Event servers Server list Template:FileLink Template:FileLink Template:FileLink Template:FileLink
Exclusive features	Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:EnvLink Template:EnvLink Template:ItemLink Template:FileLink Template:FileLink Template:EnvLink Template:EnvLink Template:EnvLink Template:PersonaLink Template:EnvLink Loading tips Template:FileLink Ray Tracing Template:BiomeLink Template:EnvLink Blocks Template:BlockLink Template:BlockLink Mobs Template:EntityLink Template:EntityLink Effects Template:EffectLink Unused Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:EntityLink Template:EntityLink Template:BiomeLink Template:EnvLink
Removed	Template:BlockLink Template:EnvLink Template:EnvLink Template:FileLink Pocket Edition protocol Legacy

ja:関数 (Bedrock Edition) pt:Funções (Edição Bedrock) uk:Функція (Bedrock Edition) zh:基岩版函数