指令/clone

出自Minecraft Wiki
跳到: 導覽搜尋
clone
限制條件

管理員

加入版本

1.814w03a
PE Alpha 0.16.0PE 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 11 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克隆模式。