We are currently performing an upgrade to our software. This upgrade will bring MediaWiki from version 1.31 to 1.33. While the upgrade is being performed on your wiki it will be in read-only mode. For more information check here.

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