コマンド/function

function

必要権限レベル	2 ‌[JE限定] 1 ‌[BE限定]
実行制限	チートのみ‌[BE限定]

このコマンドの実行文脈（実行者、実行地点、視方向など）をそのまま適用して関数を実行する。

Java Editionでは、データパックから単一の関数、あるいは関数タグに含まれるタグすべてを実行する。
Bedrock Editionでは、ビヘイビアーパックから単一の関数を実行する。

構文

• Java Edition

function

• Bedrock Edition

function

引数

JE：：function
BE：name: filepath：CommandFilePath

Java Editionでは、名前空間IDで特定の関数を指定するか、#から始まる関数のタグを指定する。Bedrock Editionでは、 path/to/function/fileの形式で[behavior_pack]/functions/path/to/function/file.mcfunctionに位置する関数を指定する。

結果

コマンド	トリガー	Java Edition	Bedrock Edition
任意	引数が正しく指定されていない	構文解析不能	構文解析不能
	指定した関数及び関数タグが存在しない	失敗	失敗
	成功時

出力

コマンド	エディション	状況	成功回数	/execute store success ...	/execute store result ...
任意	Java Edition	失敗時	0	0	0
		関数以外の方法で実行され、成功した時	関数によって実行されたコマンド+1（このコマンド自身）	1	実行されたコマンドの数（成否を問わない）+組み込まれた関数の数
		関数内で実行された場合	-	1	0
	Bedrock Edition	失敗時	0	N/A	N/A
		成功時	1	N/A	N/A

Java Edition：[1][2]

成功数は、関数により実行されたすべてのコマンドの数＋1になる。例えば、次の関数（括弧内はその内容）が存在するとき、foo:bar1（function foo:bar2）foo:bar2（function foo:bar3）foo:bar3（say hi）/function foo:bar3の成功数は1（foo:bar3内のコマンドが1つ）+1（functionコマンド自身）= 2/function foo:bar2の成功数は2（/function foo:bar3の成功数）+1（functionコマンド自身）= 3/function foo:bar1の成功数は3（/function foo:bar2の成功数）+1（functionコマンド自身）= 4となる。チャットに表示される出力メッセージは、実行されたコマンドの数（成否を問わない）+関数によって呼び出された関数の数である。/function foo:bar3の出力数は1（foo:bar3内のコマンドが1つ）/function foo:bar2の出力数は1（foo:bar2内のコマンドが1つ）+1（foo:bar3内のコマンドが1つ）+1（組み込まれた関数が1つ）= 3./function foo:bar1の出力数は1（foo:bar1内のコマンドが1つ）（foo:bar2内のコマンドが1つ）+1（foo:bar3内のコマンドが1つ）+1（組み込まれた関数が2つ）= 5となる。成功時は、/execute store successの値は1、失敗時は0になる。成功時は、/execute store resultの値は出力数と同じで、失敗時は0になる。

使用例

• Java Editionでは:

'data/functions/custom/example/test.mcfunction'の関数を実行する: function custom:example/test半径2ブロック以内に羊がいる場合に関数を実行する: execute if entity @e[type=sheep,distance=..2] run function custom:example/test実行者がプレイヤーでない場合に関数を実行する: execute unless entity @s[type=player] run function custom:example/test

歴史

Java Edition
1.12		pre1			/functionが追加された。
1.13		17w49b			引数にタグが使えるようになった。
					/execute [if/unless]の存在により、[if/unless]がこのコマンドの引数から削除された。
Bedrock Edition
1.8.0		beta 1.8.0.8			/function が追加された。

関連項目

タグ – 関数を毎tick実行する方法を解説している。

1. ↑MC-148612
2. ↑MC-135636

特に記載のない限り、コミュニティのコンテンツはCC BY-NC-SAライセンスの下で利用可能です。