手冊:/clone

出自Minecraft基岩版开发Wiki
clone
用法旗標
普通指令(0)
可見性旗標
可見(0)
同步旗標
同步指令(0)
執行旗標
允許執行(0)
型別旗標
無型別(0)
作弊旗標
作弊指令(0)
遊戲內描述

將特定區域的方塊複製到另一處。

/clone指令用於在指定區域之間複製方塊結構。

語法[編輯]

clone <begin: x y z> <end: x y z> <destination: x y z> [maskMode: MaskMode] [cloneMode: CloneMode]

clone <begin: x y z> <end: x y z> <destination: x y z> filtered <cloneMode: CloneMode> <tileName: Block> <blockStates: block states>

clone <begin: x y z> <end: x y z> <destination: x y z> filtered <cloneMode: CloneMode> <tileName: Block> <tileData: int>

參數[編輯]

beginend
x y z型別,定義源區域的兩組對角方塊區域,以指定要複製的長方體區域。可使用相對座標和局部座標來指定相對於指令執行位置的距離。
destination
x y z型別,定義複製的區域將會複製到哪裡。此區域將從各軸座標最小的地方(西北方向的較低方塊)開始載入複製的結構。可使用相對座標和局部座標來指定相對於指令執行位置的距離。
maskMode
MaskMode型別,指定是否過濾被複製方塊。必須為下列內容之一:
  • masked - 僅複製非空氣方塊,原本將被替換為空氣的方塊會保持不變。
  • replace - 複製所有的方塊,包括空氣。如果未指定參數maskMode,預設為replace
  • filtered - 僅複製指定的方塊。指定filtered將使指令額外多出幾個參數以指定待覆制的方塊。
cloneMode
CloneMode型別,指定對源區域的操作。必須為下列內容之一:
  • force - 強制複製,即使源區域和目標區域有重疊(否則源區域和目標區域是不能重疊的)。
  • move - 複製到目標區域後將源區域替換為空氣,就像是「剪下粘貼」一樣。需要指出的是,當maskModefiltered時,只有指定的方塊才會被替換為空氣。
  • normal - 正常複製粘貼。不採取forcemove的複製操作。
tileName
Block型別,指定要複製的方塊。必須為有效的方塊ID。
tileData
int型別,指定要複製方塊的資料值。
blockStates
block states型別,指定要複製方塊的方塊狀態。

效果[編輯]

指令觸發條件執行結果
任意參數未正確指定失敗
指定的區域處於未載入的區塊中
源區域選中的方塊數目超過655360(1.18+,大小相當於8個320格高的區塊)
源區域選中的方塊數目超過524288(1.17-,大小相當於8個區塊)
/clone ... move ...
/clone ... normal ...
源區域與目標區域重疊
/clone ... move ...目標區域中沒有方塊被變更(在源區域指定方塊被空氣代替之後)‌[需要測試]
/clone ... force ...
/clone ... normal ...
目標區域中沒有方塊被變更‌[需要測試]
任意執行成功複製或移動方塊

輸出[編輯]

指令執行結果成功次數增量
任意失敗0
成功1

範例[編輯]

/clone 0 0 0 20 20 20 50 50 50 - 將從(0,0,0)到(20,20,20)圍成的長方體區域複製到(50,50,50)的位置。
/clone 0 0 0 20 20 20 10 10 10 replace force - 將從(0,0,0)到(20,20,20)圍成的長方體區域強制複製到(10,10,10)的位置(如果沒有force,這指令將執行失敗,因為目標區域與源區域重疊)。
/clone 0 0 0 20 20 20 50 50 50 filtered normal grass - 將從(0,0,0)到(20,20,20)圍成的長方體區域中的草地複製到(50,50,50)的位置。

響應[編輯]

WebSocket[編輯]

範例[編輯]

腳本API[編輯]

範例[編輯]

歷史[編輯]

<!--

畫廊[編輯]

攜帶版(Alpha)