命令/schedule

schedule

需要的权限等级	2^[仅Java版] 1^{[仅基岩版]}
限制条件	启用作弊^{[仅基岩版]}

在Java版中，在经过指定的时间后执行函数。

在基岩版中，在指定的区域全部被加载时执行函数。

语法[]

Java版

schedule function <函数> <时间> [append|replace]

schedule clear <函数>

基岩版

schedule on_area_loaded add <from: x y z> <to: x y z> <function: filepath>

schedule on_area_loaded add circle <center: x y z> <radius: int> <function: filepath>

schedule on_area_loaded add tickingarea <name: string> <function: filepath>

参数[]

函数

必须为有效的函数名称或有效的标签名称。

时间^[仅Java版]

指定等待的时间。时间可以是Minecraft天、现实秒或刻（默认为刻）。

格式是非负整数加上可选的字符d、s或t。

时间值换算为刻后必须为介于0和2,147,483,647之间（含，不输入逗号）的整数，如0.5d。

append|replace（可选）^[仅Java版]

指定是否取代还在等待执行的函数或指定标签里的函数。

append — 添加等待运行的函数或指定标签里的函数。
replace — 取代还在等待运行的函数或指定标签里的函数，被取代的函数或指定标签里的函数将不会运行（仅取代相同函数名称和命名空间的目标）。

from: x y z与to: x y z^{[仅基岩版]}

指定用于定义矩形加载区域的两个对角坐标。

小于-30,000,000或大于30,000,000的x和z坐标会被视为-30,000,000或30,000,000。

center: x y z^{[仅基岩版]}

指定用于定义圆形加载区域的圆心的坐标。

小于-30,000,000或大于30,000,000的x和z坐标会被视为-30,000,000或30,000,000。

radius: int^{[仅基岩版]}

指定圆形常加载区域的半径作为从中心到圆周的区块数。

必须是从0到2,147,483,647之间的整数。

name: string^{[仅基岩版]}

指定常加载区域的名称。当此常加载区域被添加时执行函数。

效果[]

schedule function <函数> <时间> (append|replace)^[仅Java版]

若命令指定的函数、时间无效或缺少应有的参数则命令失败。

成功时，将函数列入等待队列，并在等待了足够时间后运行。

schedule clear <函数>^[仅Java版]

若命令指定的函数没有在等待队列中，则命令失败。

成功时，将等待运行的函数从等待队列中删除。

schedule on_area_loaded add <from: x y z> <to: x y z> <function: filepath>^{[仅基岩版]}

schedule on_area_loaded add circle <center: x y z> <radius: int> <function: filepath>^{[仅基岩版]}

指定的区块超过2,147,483,647个时失败。

如果指定的区块未被全部加载，则将函数列入等待队列，全部加载时由服务器在(0,0,0)执行。

如果指定的区块已被全部加载，则函数由此命令的执行者立刻执行。

schedule on_area_loaded add tickingarea <name: string> <function: filepath>^{[仅基岩版]}

如果指定的常加载区域未被添加，则将函数列入等待队列，被添加时由服务器在(0,0,0)执行。

如果指定的常加载区域已存在，则函数由此命令的执行者立刻执行。

示例[]

在3秒后运行函数foo:bar：schedule function foo:bar 3s^[仅Java版]

在5天后运行标签foo:bar里的函数：schedule function #foo:bar 5d^[仅Java版]

在名称为temp的常加载区域被添加时运行函数a：schedule on_area_loaded add tickingarea temp a^{[仅基岩版]}

历史[]

Java版
1.14	18w43a	加入了`/schedule`。
1.15	19w38a	加入了`clear`语法和可选的`append/replace`参数（默认为`replace`）。
基岩版
1.16.100	1.16.100.59	加入了`/schedule`。

命令

Minecraft Wiki