在指定区域之间复制方块结构。
语法
- 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方块大小的区域。
- 构成边角的方块在此方块的坐标正方向上延伸。因此，各轴上较小的坐标将会正好贴合区域边界，但较大的坐标将会超过边界1方块，源区域的体积则为(x大 - x小 + 1) × (y大 - y小 + 1) × (z大 - z小 + 1)。例如：
- 目标（基岩版：目标: 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模式下为必需参数。
- 指定当遮罩模式设置为
- 数据值（可选）
- 指定复制时需要符合的方块数据值。
效果
- 除了使用move复制模式，在命令执行成功时，目标区域会被源区域的方块覆盖，而源区域不变。
历史
| Java版 | |||||
|---|---|---|---|---|---|
| 1.8 | 14w03a | 加入了/clone命令。 | |||
| 14w10a | 加入了force选项。 | ||||
| 14w20a | 加入了move选项。 | ||||
| 携带版Alpha | |||||
| 0.16.0 | build 1 | 加入了/clone命令。
| |||
/clone命令不能使用forced克隆模式。 | |||||
参见
/fill— 用一类方块填充整个区域