手册:/clone

clone

命令

权限等级

1

命令旗标

用法旗标

普通命令（0）

可见性旗标

可见（0）

同步旗标

同步命令（0）

执行旗标

允许执行（0）

类型旗标

无类型（0）

作弊旗标

作弊命令（0）

游戏内描述

“

将特定区域的方块复制到另一处。

”

限制条件

无

/clone命令用于在指定区域之间复制方块结构。

语法

clone <begin: x y z> <end: x y z> <destination: x y z> [maskMode: MaskMode] [cloneMode: CloneMode]

clone <begin: x y z> <end: x y z> <destination: x y z> filtered <cloneMode: CloneMode> <tileName: Block> <blockStates: block states>

clone <begin: x y z> <end: x y z> <destination: x y z> filtered <cloneMode: CloneMode> <tileName: Block> <tileData: int>

参数

begin与end

x y z类型，定义源区域的两组对角方块区域，以指定要复制的长方体区域。可使用相对坐标和局部坐标来指定相对于命令执行位置的距离。

destination

x y z类型，定义复制的区域将会复制到哪里。此区域将从各轴坐标最小的地方（西北方向的较低方块）开始加载复制的结构。可使用相对坐标和局部坐标来指定相对于命令执行位置的距离。

maskMode

MaskMode类型，指定是否过滤被复制方块。必须为下列内容之一：

• masked - 仅复制非空气方块，原本将被替换为空气的方块会保持不变。
• replace - 复制所有的方块，包括空气。如果未指定参数maskMode，默认为replace。
• filtered - 仅复制指定的方块。指定filtered将使命令额外多出几个参数以指定待复制的方块。

cloneMode

CloneMode类型，指定对源区域的操作。必须为下列内容之一：

• force - 强制复制，即使源区域和目标区域有重叠（否则源区域和目标区域是不能重叠的）。
• move - 复制到目标区域后将源区域替换为空气，就像是“剪切粘贴”一样。需要指出的是，当maskMode为filtered时，只有指定的方块才会被替换为空气。
• normal - 正常复制粘贴。不采取force和move的复制操作。

tileName

Block类型，指定要复制的方块。必须为有效的方块ID。

tileData

int类型，指定要复制方块的数据值。

blockStates

block states类型，指定要复制方块的方块状态。

效果

命令	触发条件	执行结果
任意	参数未正确指定	失败
	指定的区域处于未加载的区块中
	源区域选中的方块数目超过655360（1.18+，大小相当于8个320格高的区块）
	源区域选中的方块数目超过524288（1.17-，大小相当于8个区块）
/clone ... move ... /clone ... normal ...	源区域与目标区域重叠
/clone ... move ...	目标区域中没有方块被更改（在源区域指定方块被空气代替之后）‌[需要测试]
/clone ... force ... /clone ... normal ...	目标区域中没有方块被更改‌[需要测试]
任意	执行成功	复制或移动方块

输出

命令	执行结果	成功次数增量
任意	失败	0
	成功	1

示例

/clone 0 0 0 20 20 20 50 50 50 - 将从(0,0,0)到(20,20,20)围成的长方体区域复制到(50,50,50)的位置。

/clone 0 0 0 20 20 20 10 10 10 replace force - 将从(0,0,0)到(20,20,20)围成的长方体区域强制复制到(10,10,10)的位置（如果没有force，这命令将执行失败，因为目标区域与源区域重叠）。

/clone 0 0 0 20 20 20 50 50 50 filtered normal grass - 将从(0,0,0)到(20,20,20)围成的长方体区域中的草方块复制到(50,50,50)的位置。

历史

<!--

画廊

• 
  /clone命令的帮助信息
• 
  执行/clone ...后的效果。把左边的方块复制到右边，其中红色方块为坐标最小位置（利用这点可能帮助你不会错误的把方块复制到错误的位置）
• 
  执行/clone ... filtered move concrete 15后的效果。把黑色的混凝土“移动”到目标位置

携带版（Alpha）