手冊:/clone

clone

命令

權限等級

1

命令旗標

用法旗標

普通命令（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>

參數

begin與end

x y z型別，定義源區域的兩組對角方塊區域，以指定要複製的長方體區域。可使用相對座標和局部座標來指定相對於命令執行位置的距離。

destination

x y z型別，定義複製的區域將會複製到哪裏。此區域將從各軸座標最小的地方（西北方向的較低方塊）開始載入複製的結構。可使用相對座標和局部座標來指定相對於命令執行位置的距離。

maskMode

MaskMode型別，指定是否過濾被複製方塊。必須為下列內容之一：

• masked - 僅複製非空氣方塊，原本將被替換為空氣的方塊會保持不變。
• replace - 複製所有的方塊，包括空氣。如果未指定參數maskMode，預設為replace。
• filtered - 僅複製指定的方塊。指定filtered將使命令額外多出幾個參數以指定待覆制的方塊。

cloneMode

CloneMode型別，指定對源區域的操作。必須為下列內容之一：

• force - 強制複製，即使源區域和目標區域有重疊（否則源區域和目標區域是不能重疊的）。
• move - 複製到目標區域後將源區域替換為空氣，就像是「剪下粘貼」一樣。需要指出的是，當maskMode為filtered時，只有指定的方塊才會被替換為空氣。
• normal - 正常複製粘貼。不採取force和move的複製操作。

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)的位置。

歷史

<!--

畫廊

• 

  /clone命令的幫助資訊

• 

  執行/clone ...後的效果。把左邊的方塊複製到右邊，其中紅色方塊為座標最小位置（利用這點可能幫助你不會錯誤的把方塊複製到錯誤的位置）

• 

  執行/clone ... filtered move concrete 15後的效果。把黑色的混凝土「移動」到目標位置

攜帶版（Alpha）