命令/clone

来自Minecraft Wiki
跳转至: 导航搜索
clone
需要的权限等级

2[仅Java版]
1[仅基岩版]

限制条件

启用作弊[仅基岩版]

在指定区域之间复制方块结构。

语法[编辑 | 编辑源代码]

  • Java版
clone <开始> <结束> <目的位置> [replace|masked] [force|move|normal]
clone <开始> <结束> <目的位置> filtered <过滤方块> [force|move|normal]
  • 基岩版
clone <开始: x y z> <结束: x y z> <目标: x y z> [遮罩模式:遮罩模式] [复制模式:复制模式]
clone <开始: x y z> <结束: x y z> <目标: x y z> filtered <复制模式:复制模式> [方块名:方块] [方块数据:整数]

参数[编辑 | 编辑源代码]

Java版: 开始结束

基岩版: 开始: 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方块大小的区域。

Java版: 目的位置

基岩版: 目的位置: x y z

定义目标区域的西北方向较低(即在各轴上坐标值最小)的点的坐标,游戏会根据开始结束的坐标算出目标区域的范围。可以使用相对坐标和局部坐标来指定命令执行地的相对距离

Java版: replace|masked|filtered

基岩版: 遮罩模式:遮罩模式

指定是否过滤被复制方块。必须为下列之一:
  • masked — 仅复制非空气方块。会保持目的区域中原本会被替换为空气的方块不变。
  • replace — 复制所有方块,用源区域的方块覆盖目标区域中的所有方块。
若未定义,默认为replace

Java版: force|move|normal

基岩版: 复制模式:复制模式

指定对源区域的操作。必须为下列之一:
  • force — 强制复制,即使源区域与目标区域有重叠。
  • move — 将源区域复制到目标区域,并将源区域替换为空气。在filtered遮罩模式下,只有被复制的方块才会被替换为空气。
  • normal — 不执行force与move。
若未指定,默认为normal

Java版: 过滤方块

基岩版: 方块名:方块

指定在filtered模式下时要复制的方块ID(示例:minecraft:stone)。

基岩版: 方块数据:整数

指定复制时需要符合的方块数据值。

效果[编辑 | 编辑源代码]

命令触发条件Java版基岩版
任意参数未正确指定 无法解析 执行失败
指定的区域处于已卸载的区块中 执行失败
源区域被选中的方块数量超过32768 (相当于8个区块横截面的方块数量) N/A
源区域被选中的方块数量超过524288(相当于8个区块的方块数量) N/A 执行失败
/clone ... move ...
/clone ... normal ...
源区域和目标区域重叠 执行失败
/clone ... move ...目标区域中没有方块被更改(在源区域指定方块被空气代替之后
/clone ... force ...
/clone ... normal ...
目标区域中没有方块被更改
任意执行成功时复制或移动方块

输出[编辑 | 编辑源代码]

命令版本条件成功次数/execute store success .../execute store result ...
任意Java版失败时000
成功时11目标区域中被更改的方块数
基岩版失败时0N/AN/A
成功时1N/AN/A

历史[编辑 | 编辑源代码]

Java版
1.814w03a加入了/clone命令。
14w10a加入了force选项。
14w20a加入了move选项。
携带版Alpha
0.16.0build 1加入了/clone命令。
/clone命令不能使用force克隆模式。

参见[编辑 | 编辑源代码]

  • /fill — 用一类方块填充整个区域