手册:/clone

From Minecraft基岩版开发Wiki
clone
用法旗标
普通命令(0)
可见性旗标
可见(0)
同步旗标
同步命令(0)
执行旗标
允许执行(0)
类型旗标
无类型(0)
作弊旗标
作弊命令(0)
游戏内描述

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

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

语法[edit]

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>

参数[edit]

beginend
x y z类型,定义源区域的两组对角方块区域,以指定要复制的长方体区域。可使用相对坐标和局部坐标来指定相对于命令执行位置的距离。
destination
x y z类型,定义复制的区域将会复制到哪里。此区域将从各轴坐标最小的地方(西北方向的较低方块)开始加载复制的结构。可使用相对坐标和局部坐标来指定相对于命令执行位置的距离。
maskMode
MaskMode类型,指定是否过滤被复制方块。必须为下列内容之一:
  • masked - 仅复制非空气方块,原本将被替换为空气的方块会保持不变。
  • replace - 复制所有的方块,包括空气。如果未指定参数maskMode,默认为replace
  • filtered - 仅复制指定的方块。指定filtered将使命令额外多出几个参数以指定待复制的方块。
cloneMode
CloneMode类型,指定对源区域的操作。必须为下列内容之一:
  • force - 强制复制,即使源区域和目标区域有重叠(否则源区域和目标区域是不能重叠的)。
  • move - 复制到目标区域后将源区域替换为空气,就像是“剪切粘贴”一样。需要指出的是,当maskModefiltered时,只有指定的方块才会被替换为空气。
  • normal - 正常复制粘贴。不采取forcemove的复制操作。
tileName
Block类型,指定要复制的方块。必须为有效的方块ID。
tileData
int类型,指定要复制方块的数据值。
blockStates
block states类型,指定要复制方块的方块状态。

效果[edit]

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

输出[edit]

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

示例[edit]

/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)的位置。

响应[edit]

WebSocket[edit]

示例[edit]

脚本API[edit]

示例[edit]

历史[edit]

<!--

画廊[edit]

携带版(Alpha)