Minecraft:Commands/function

Runs commands found in the corresponding function file(s) with command execution context (executor, execution position, angles, etc) of the /function command itself.

Usage

in Template:Editions, runs a function or all functions in a tag from a data pack.

in Template:Editions, runs a function from a Minecraft:behavior pack.

in Template:Editions, the behavior of

1. REDIRECT Template:Command

Template:Redr (or

1. REDIRECT Template:Command

Template:Redr) is different with a direct call to the

1. REDIRECT Template:Command

Template:Redr command. If

1. REDIRECT Template:Command

Template:Redr runs multiple functions, execution stops after first

1. REDIRECT Template:Command

Template:Redr in any of the functions. If a direct call to the

1. REDIRECT Template:Command

Template:Redr runs multiple functions, all of the functions are executed, and the return values are added up as the result value of the

1. REDIRECT Template:Command

Template:Redr command.

Syntax

• Java Edition

function <name>

Runs a function or functions in a tag.

function <name> <arguments>

function <name> with (block <sourcePos>|entity <source>|storage <source>) [<path>]

Runs a function or functions in a tag, with arguments for macros.

• Bedrock Edition

function <name: filepath>

Runs a function.

Arguments

Template:El: <name>: function
Template:El: name: filepath: CommandFilePath

Specifies the function(s) to execute.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|function}}{{#vardefine:be-arg|function}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

1. REDIRECT Template:Edition

Template:Rcat: <arguments>: nbt_compound_tag

Specifies arguments for macro functions in a compound NBT tag.

{{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|nbt_compound_tag}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

1. REDIRECT Template:Edition

Template:Rcat: <sourcePos>: block_pos

The position of the target Minecraft:block entity whose NBT is to be used.

{{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|block_pos}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

1. REDIRECT Template:Edition

Template:Rcat: <source>: entity (in entity <target> mode)

Specifies an entity whose NBT is to be used.

{{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|entity}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

1. REDIRECT Template:Edition

Template:Rcat: <source>: resource_location (in storage <target> mode)

Specifies a storage whose NBT is to be used.

{{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|resource_location}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

1. REDIRECT Template:Edition

Template:Rcat: <path>: nbt_path

Specifies the NBT path. Should be a path of a single compound tag.

{{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|nbt_path}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

Output

in Template:Editions, for

1. REDIRECT Template:Command

Template:Redr:

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

{{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|N/A}}{{#vardefine:output2-{{#var:output-table-lines}}|0}}{{#vardefine:output3-{{#var:output-table-lines}}|0}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-editions-num|}}{{#vardefine:output-edition-{{#var:output-editions-num}}|je}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On void}}{{#vardefine:output1-{{#var:output-table-lines}}|N/A}}{{#vardefine:output2-{{#var:output-table-lines}}|unchanged}}{{#vardefine:output3-{{#var:output-table-lines}}|unchanged}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}} Template:Output table

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

in Template:Editions, otherwise:

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

{{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|0}}{{#vardefine:output3-{{#var:output-table-lines}}|0}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-editions-num|}}{{#vardefine:output-edition-{{#var:output-editions-num}}|je}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On void}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|unchanged}}{{#vardefine:output3-{{#var:output-table-lines}}|unchanged}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|1}}{{#vardefine:output3-{{#var:output-table-lines}}|the sum of the return values of all the non-void functions}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}}

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

in Template:Editions:

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

{{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-editions-num|}}{{#vardefine:output-edition-{{#var:output-editions-num}}|be}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}}

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

Examples

• in Template:Editions:
  • To run a function located at data/custom/function/example/test.mcfunction in a loaded data pack:

1. REDIRECT Template:Command

• • To run all functions in a function tag located at data/custom/tags/function/example/test.json:

1. REDIRECT Template:Command

• • To run a function if there is a sheep within a radius of 2 blocks: /execute if entity @e[type=sheep,distance=..2] run function custom:example/test
  • To run a function unless the executor is a player: /execute unless entity @s[type=player] run function custom:example/test
  • To run a function macro with arguments a=42, b="example": /function custom:example/test {a: 42, b: "example"}
  • To run a function macro with arguments from storage custom:storage: /function custom:example/test with custom:storage

History

See also

1. REDIRECT Template:Command

Template:Redr – To run function in batch, every tick, or on server (re)load.

References

<references group="">

 </references>

External links

• Template:Cite

Navigation

All editions	clear clone damage deop difficulty effect enchant execute fill function gamemode gamerule give help kick kill list locate loot me msg op particle place playsound recipe reload ride say schedule scoreboard setblock setworldspawn spawnpoint spreadplayers stopsound summon tag teleport tell tellraw time title tp transfer w weather xp Removed placefeature
Template:El only	advancement attribute ban ban-ip banlist bossbar data datapack debug defaultgamemode dialog experience fetchprofile fillbiome forceload item jfr pardon pardon-ip publish random return save-all save-off save-on seed setidletimeout spectate stopwatch swing team teammsg tm test tick trigger version waypoint worldborder Debug chase debugconfig debugmobspawning debugpath raid serverpack spawn_armor_trims warden_spawn_tracker Removed ? achievement banip blockdata broadcast chunk entitydata home iron locatebiome replaceitem setspawn solid stats testfor testforblock testforblocks toggledownfall unban wood
Template:Els only	stop whitelist
Template:El only	aimassist allowlist changesetting clearrealmevents controlscheme dedicatedwsserver gametips packstack project reloadconfig reloadpacketlimitconfig save sendshowstoreoffer set_movement_authority Removed aigoals automate automateactivetool automatebreakblock automatefindblock automatefly automategetinteractionpositionforblock automatelookat automatemove automatemoveto automateplaceblock bhave bossbar bounds cleanroom clearslot clearinventory crash crashclient crashserver createlocalworld destroyblock detect dumpblocknames dumpentitiesclient dumpentitiesserver enchantrandom fillchestblock filldrive findanchoredbuildpos findflatarea findnearbypickups fixbiomes fly getactivescreen getavgendframerate getavgremaindertimepercent getavgrendertime getavgticktime getavgunaccountedtimepercent getblockname getbrightness getchestcontents getchunkdirtycount getchunkrebuildcount getchunksortcount getcpu getdurability getexperience getfps getgpu getgpumemory getguiscale getmsaalevel getos getplayerbiome getplayerid getpos getpower getprofilersecondsperupdate getresolution getselecteditemcount getskin getstructure getsysteminfo getsystemmem getviewdistance getworldname health hunger islargechestblock isplayercrouching isplayerflying isplayergrounded isworldloaded kit leaveworld loadbehaviortreedefinitions log lookat memwarn mixer nearbyentityisbaby networkstats notifyprofiler paths pause placefromhand playerstat profile redstonetest register3pserver resupply rot selectinventoryitem sendmodalform setbrightness setguiscale setskin setviewdistance showallitems showfrustum simlock simscale simulationtype skin spawnfeature spawning spawnitem spawnmob stoptime systemstat testassets timelock tptobiome tptosuitabletree villages volumearea wipeout
Template:El only	classroommode closechat code codebuilder lesson remove videostream Removed position videostreamaction
Template:Els only	? ability agent alwaysday camera camerashake clearspawnpoint codebuilder_actorinfo connect daylock dialogue drop enableencryption event fog getlocalplayername gettopsolidblock hud immutableworld inputpermission listd mobevent music ops permission playanimation querytarget replaceitem script scriptevent setmaxplayers structure takepicture testfor testforblock testforblocks tickingarea titleraw toggledownfall wb worldbuilder wsserver Removed clearfixedinv executeasself move place setfixedinvslot setfixedinvslots test transferserver
Joke	debugdim transform vote warp
Related	Argument types Permission level Slot Target selectors

de:Befehl/function es:Comandos/function ja:コマンド/function ko:명령어/function pt:Comandos/function ru:Команды консоли/function uk:Команди консолі/function zh:命令/function