マクロとは

ファンクション内のコマンド行の一部分を未確定にして書き、functionコマンドの実行時に指定したNBTの値から未確定の部分を確定させてファンクションを実行する機能です。

基本の使い方

例えばsetblockコマンドが書かれたファンクションがあるとします。

setblock.mcfunction

setblock ~ ~ ~ stone

当たり前ですがこのままでは石以外のブロックを設置することはできません。

そこで設置するブロックの指定部分をマクロで未確定にしてみます。

setblock.mcfunction

$setblock ~ ~ ~ $(block)

マクロを使用する行では最初に$を付けます。
マクロで未確定にする部分は$(任意の名前)と書きます。
今回このマクロはblockという名前にしました。

このマクロが含まれたファンクションは次の様なfunctionコマンドから実行します。

main.mcfunction

function func:setblock {block:"glass"}

{}で囲われたNBTの中にblockという名前のタグが入っています。

こうすることで$(block)の部分が{block:"glass"}のglassで確定させられます。

つまり

setblock.mcfunction

$setblock ~ ~ ~ $(block)

が

setblock ~ ~ ~ glass

に変換されるため、実行の結果ガラスが設置されます。

functionコマンドで指定するNBTはwithでストレージなどを参照可能です。

main.mcfunction

data modify storage strg: setblk set value {block:"glass"}
function func:setblock with storage strg: setblk

setblock.mcfunction

$setblock ~ ~ ~ $(block)

setblock ~ ~ ~ glass

そのためストレージに保存されたブロックのデータからsetblockをするなどの
今まで難しかったことが可能になりました。

dataコマンドでリストのインデックス（何番目かの指定）を動的に変更する

$data get storage strg: list[$(index)]

functionコマンドで実行するファンクションを動的に変更する

$function $(func)