在基岩版中,在指定的区域全部被加载时执行函数。
语法[]
- 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>
参数[]
函数
- 必须为有效的函数名称或有效的标签名称。
时间
- 指定等待的时间。时间可以是Minecraft天、现实秒或刻(默认为刻)。
- 格式是非负整数加上可选的字符
d
、s
或t
。 - 时间值换算为刻后必须为介于0和2,147,483,647之间(含,不输入逗号)的整数,如
0.5d
。
append|replace
(可选)
- 指定是否取代还在等待执行的函数或指定标签里的函数。
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
- 指定常加载区域的名称。当此常加载区域被添加时执行函数。
效果[]
命令 | 触发条件 | Java版 | 基岩版 |
---|---|---|---|
任意 | 参数不正确 | 无法解析 | 无法解析 |
指定函数(包)不存在 | 执行失败 | 执行失败 | |
指定函数所需的源无效 | N/A | 执行失败 | |
/schedule function ... | <time> 为0 | N/A | |
/schedule clear ... | 指定函数未在等待队列中 | ||
/schedule on_area_loaded add <from: x y z> <to: x y z> ... | 指定区域大于2,147,483,647区块 | N/A | 执行失败 |
/schedule on_area_loaded add circle ... | <radius: int>小于0 | ||
任意 | 执行成功时 | 在等待队列中设置或删除函数 |
输出[]
命令 | 版本 | 条件 | 成功次数 | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
任意 | Java版 | 失败 | 0 | 0 | 0 |
/schedule function ... | 成功 | 1 | 1 | 函数执行时间 | |
/schedule clear ... | 成功 | 1 | 1 | 被清除的函数数 | |
基岩版 | 失败 | 0 | N/A | N/A | |
On success | 1 | N/A | N/A |
示例[]
- 在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 。 |
语言