指令/clone

clone

限制條件	是管理員
加入版本	1.8（14w03a） PE Alpha 0.16.0（PE Alpha 0.16.0 build 1）

在區域之間複製方塊結構。

語法

• Java版

clone <开始> <结束> <目标> [filtered|replace|masked] [<复制模式>] [<方块>]

• 基岩版

clone <开始: x y z> <结束: x y z> <目标: x y z> [replace|masked] [normal|move|force] [方块：方块] [方块数据：整数]

clone <开始: x y z> <结束: x y z> <目标: x y z> filtered <normal|move|force> [方块名：字符串] [方块数据：整数]

上方的背景色是為了方便閱讀。遊戲內clone指令的幫助信息中沒有最後一個參數：方塊名，此處是為了後續討論而設。

參數

開始與結束（基岩版：開始: x y z與結束: x y z）

定義源區域的兩組對角方塊坐標。可以使用波浪號來指定指令執行地的相對距離。

構成邊角的方塊在此方塊的坐標正方向上延伸。因此，各軸上較小的坐標將會正好貼合區域邊界，但較大的坐標將會超過邊界1方塊，源區域的體積則為(x_大 - x_小 + 1) × (y_大 - y_小 + 1) × (z_大 - z_小 + 1)。例如：0 0 0 0 0 0的體積為1方塊，0 0 0 1 1 1與1 1 1 0 0 0都指定同一塊8方塊大小的區域。

目標（基岩版：目標: x y z）

定義目標區域的西北方向較低（即在各軸上坐標值最小）的點的坐標，遊戲會根據開始與結束的坐標算出目標區域的範圍。可以使用波浪號來指定指令執行地的相對距離。注意：是目標區域各軸坐標值最小的點的坐標，而不是與開始坐標對應的坐標。

replace|masked|filtered（可選）

指定是否過濾被複製方塊。必須為下列之一：

• filtered — 僅複製方塊ID符合方塊名定義的方塊。
• masked — 僅複製非空氣方塊。會保持目的區域中原本會被替換為空氣的方塊不變。
• replace — 複製所有方塊，用源區域的方塊覆蓋目標區域中的所有方塊。

若未定義，預設為replace。

normal|force|move（可選）

指定對源區域的操作。必須為下列之一：

• force — 強制複製，即使源區域與目標區域有重疊。
• move — 將源區域複製到目標區域，並將源區域替換為空氣。在filtered遮罩模式下，只有被複製的方塊才會被替換為空氣。
• normal — 不執行force與move。

若未指定，預設為normal。

方塊（基岩版：方塊：方塊）（可選）

指定當遮罩模式設定為filtered時要複製的方塊ID（示例：minecraft:stone）。在filtered模式下為必需參數。

數據值（可選）

指定複製時需要符合的方塊數據值。

效果

若參數沒有被正確指定，或源區域的方塊體積大於32768（足夠複製8個區塊的區域），或源區域與目標區域重合（除非使用了force複製模式），或者源區域與目標區域尚未被渲染時，則失敗。

成功時，將目標區域用源區域的方塊覆蓋，源區域不變（除非使用了move複製模式）。

另見

/fill — 用一類方塊填充整個區域

歷史

Java版
1.8		14w03a			加入了/clone指令。
		14w10a			加入了force選項。
		14w20a			加入了move選項。
攜帶版（Alpha）
0.16.0		build 1			加入了/clone指令。
					/clone指令不能使用forced克隆模式。