在基岩版中,在指定的區域全部被載入時執行函數。
語法[]
- 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 。 |
語言