命令/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克隆模式。