指令/schedule

schedule

需要的權限等級	Java版：2 基岩版：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^{[僅基岩版]}

指定常載入區域的名稱。當此常載入區域被加入時執行函數。

效果[]

指令	觸發條件	Java版	基岩版
任意	參數不正確	無法解析	無法解析
	指定函數（包）不存在	執行失敗	執行失敗
	指定函數所需的源無效	N/A	執行失敗
`/schedule function ...`	`<time>`為0		N/A
`/schedule clear ...`	指定函數未在等待隊列中		N/A
`/schedule on_area_loaded add <from: x y z> <to: x y z> ... /schedule on_area_loaded add circle ...`	指定區域大於2,147,483,647區塊	N/A	執行失敗
`/schedule on_area_loaded add circle ...`	<radius: int>小於0	N/A	執行失敗
任意	執行成功時	在等待隊列中設定或刪除函數

輸出[]

指令	版本	條件	成功次數	`/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`。

指令

Minecraft Wiki