指定した領域のブロックを別の領域に複製する。
構文[]
- Java Edition
clone . . .clone from <sourceDimension> . . .... <begin> <end> . . .... <destination> . . .... to <targetDimension> <destination> . . .... [replace|masked] [force|move|normal]- 全てのブロック、あるいは空気以外のブロックを複製する。
... filtered <filter> [force|move|normal]<filter>で指定されたブロックのみを複製する。
簡略化された構文規則
clone <begin> <end> . . .clone from <sourceDimension> <begin> <end> . . .... <destination> . . .... to <targetDimension> <destination> . . .... [replace|masked] [force|move|normal]... filtered <filter> [force|move|normal]
完全な構文規則
clone <begin> <end> <destination>clone from <sourceDimension> <begin> <end> <destination>clone <begin> <end> <destination> replace [force|move|normal]clone from <sourceDimension> <begin> <end> <destination> replace [force|move|normal]clone <begin> <end> <destination> masked [force|move|normal]clone from <sourceDimension> <begin> <end> <destination> masked [force|move|normal]clone <begin> <end> <destination> filtered <filter> [force|move|normal]clone from <sourceDimension> <begin> <end> <destination> filtered <filter> [force|move|normal]clone <begin> <end> to <targetDimension> <destination>clone from <sourceDimension> <begin> <end> to <targetDimension> <destination>clone <begin> <end> to <targetDimension> <destination> replace [force|move|normal]clone from <sourceDimension> <begin> <end> to <targetDimension> <destination> replace [force|move|normal]clone <begin> <end> to <targetDimension> <destination> masked [force|move|normal]clone from <sourceDimension> <begin> <end> to <targetDimension> <destination> masked [force|move|normal]clone <begin> <end> to <targetDimension> <destination> filtered <filter> [force|move|normal]clone from <sourceDimension> <begin> <end> to <targetDimension> <destination> filtered <filter> [force|move|normal]
- Bedrock Edition
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><tileName: Block>で指定されたブロックのみを複製する。
引数[]
- JE：
<begin>：ブロック座標および<end>：ブロック座標 - BE：
begin: x y z：CommandPositionおよびend: x y z：CommandPosition - コピー元の領域の、対向する2つの角の座標を指定する。
- Java Editionでは,整数またはチルダ・キャレット表記法で表記された<x>、<y>、<z>でブロック座標を指定する。 Bedrock Editionでは,<x>、<y>、<z>の各値は、浮動小数点数またはチルダ・キャレット表記法で表記された3次元座標を指定する。
- ブロックの位置は、ブロックの北西下面の頂点の座標となる。このため、各軸の小さい方の座標は領域境界上となるが、大きい方の座標は境界から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ブロックの体積となる。
- JE：
<destination>：ブロック座標
BE：destination: x y z：座標 - コピー先領域の北西下隅（つまり、各軸の最小座標）を指定する。デバッグ画面に表示されるXYZ軸の原点の位置と対照すると分かりやすい。
- Java Editionでは,整数またはチルダ・キャレット表記法で表記された<x>、<y>、<z>でブロック座標を指定する。 Bedrock Editionでは,<x>、<y>、<z>の各値は、浮動小数点数またはチルダ・キャレット表記法で表記された3次元座標を指定する。
- JE：
replace|masked - BE：
maskMode: MaskMode：enum - コピーされるブロックをどうフィルタリングするかを指定する。以下のいずれかを指定する。
replace— 全てコピーする。コピー先のブロックは全てコピー元のブロックで置き換えられる。masked— 空気以外のブロックをコピーする。コピー元で空気ブロックに相当する部分のコピー先ブロックは置き換えられずそのまま残る。
- 省略した場合、
replaceが指定されたものとして扱われる。
- JE：
force|move|normal - BE：
cloneMode: CloneMode：enum - コピー元の領域をどう扱うかを指定する。以下のいずれかを指定する。
force— コピー元とコピー先の領域が重なっていたとしても無理矢理コピーする。move— コピー元をコピー先の領域にコピーし、コピー元があった領域は空気で置き換える。フィルタリングが有効の場合、コピーされたブロックのみ空気で置き換えられる。normal— 移動も置き換えもしない。
- 省略した場合、
normalが指定されたものとして扱われる。
- JE：
<filter>：ブロック条件
BE：tileName: Block：文字列（引用符無し） filteredモードでコピーするブロックを指定する。- Java Editionでは,ブロック引数（ブロックタグは使用可能）を指定する。 Bedrock Editionでは,ブロックIDを指定する。
- BE：
blockStates: block states：BlockStateCommandParam - コピー対象となるブロックを指定する際のブロック状態を指定する。
["<state1>":<value1>,"<state2>":<value2>,...]のようにブロック状態引数を指定する。例：["old_leaf_type":"birch","persistent_bit":true]
結果[]
| コマンド | トリガー | Java Edition | Bedrock Edition |
|---|---|---|---|
| 任意 | 引数が正しく指定されていない場合 | 構文解析不能 | 構文解析不能 |
| 少なくともいずれかの座標が読み込まれていない、またはワールドの範囲外の場合 | 失敗 | 失敗 | |
指定された範囲のブロックの大きさがゲームルールcommandModificationBlockLimitの値を超えている場合 | N/A | ||
| 指定された範囲のブロックの大きさが524288（8チャンク分）を超えている場合 | N/A | 失敗 | |
/clone ... normal ... | コピー元領域とコピー先領域が重なっている場合 | 失敗 | |
/clone ... move ... | コピー元領域とコピー先領域が重なっている場合 | 成功 | |
/clone ... filtered ... | コピー元領域に指定されたブロックが1つも存在しない場合 | 失敗 | |
/clone ... replace ... | コピー元領域のブロックが全てバリアブロックである場合[1] | 失敗 | N/A |
/clone ... masked ... | コピー元領域に空気でもバリアブロック[1]でもないブロックが1つも存在しない場合 | ||
/clone ... filtered ... | バリアブロックを指定した場合[1] | ||
/clone ... masked ... | コピー元領域に空気でないブロックが1つも存在しない場合 | N/A | 失敗 |
| 任意 | 上記以外の場合 | 成功 | 成功 |
出力[]
| コマンド | エディション | 状況 | 成功回数 | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| 任意 | Java Edition | 失敗時 | 0 | 0 | 0 |
| 成功時 | 1 | 1 | 正常に複製されたブロックの数 | ||
| Bedrock Edition | 失敗時 | 0 | N/A | N/A | |
| 成功時 | 1 | N/A | N/A |
歴史[]
| Java Edition | |||||
|---|---|---|---|---|---|
| 1.8 | 14w03a | /cloneが追加された。 | |||
| 14w10a | forceオプションが追加された。 | ||||
| 14w20a | moveオプションが追加された。 | ||||
| 1.19.4 | 23w03a | 引数dimensionが追加された。
| |||
指定可能な領域のブロック数の上限が32768で固定されず、ゲームルールcommandModificationBlockLimitで設定できるようになった。 | |||||
| Pocket Edition Alpha | |||||
| 0.16.0 | build 1 | /cloneが追加された。 | |||
/cloneはforcedモードで使用することはできない。 | |||||
| Bedrock Edition | |||||
| 1.16.210 | beta 1.16.210.53 | ブロック状態を指定できるようになった。 | |||
| beta 1.16.210.57 | 同種のブロックの複製が失敗として扱われなくなった。 | ||||
| 1.19.70 | beta 1.19.70.21 | 引数tileData: intが削除された。 | |||
脚注[]
関連項目[]
/fill– ブロックを一括で設置する。