Minecraft:Commands/clone: Difference between revisions

← Older edit

VisualWikitext

Latest revision as of 11:13, 10 August 2026

Template:Infobox command

Clones Minecraft:blocks from one region to another.

Syntax

Java Edition

clone . . .

clone from <sourceDimension> . . .

... <begin> <end> . . .
- ... <destination> . . .
- ... to <targetDimension> <destination> . . .
  - ... [strict] [replace] [force|move|normal]
    Clones all blocks.
  - ... [strict] masked [force|move|normal]
    Clones non-Minecraft:air blocks.
  - ... [strict] filtered <filter> [force|move|normal]
    Clones only blocks with the block id specified by <filter>.

Syntax displayed in various ways

Simplified tree:
`clone <begin> <end> . . .` `clone from <sourceDimension> <begin> <end> . . .` `... <destination> . . .` `... to <targetDimension> <destination> . . .` `... [strict] [replace\|masked] [force\|move\|normal]` `... [strict] filtered <filter> [force\|move\|normal]`

Maximised:

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]

Clones all blocks or only non-air blocks.

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

Clones only blocks with the block id specified by <tileName: Block>.

Arguments

Template:El: Template:Argument

Specifies the dimension to clone the blocks from. If unspecified, defaults to current execution dimension.

Template:Arg desc

Template:El: Template:Argument and Template:Argument
Template:El: Template:Argument and Template:Argument

Specifies the coordinates of two opposing corner blocks of the source region.

Template:Arg desc

Block position is the coordinates of the point at the lower northwest corner of a block. Because of this, the lesser coordinates of each axis falls right on the region boundary, but the greater coordinates are one block from the boundary, and the block volume of the source region is (x_greater - x_lesser + 1) × (y_greater - y_lesser + 1) × (z_greater - z_lesser + 1). For example, 0 0 0 0 0 0 has a 1-block volume, and 0 0 0 1 1 1 and 1 1 1 0 0 0 both identify the same region with an 8-block volume.

Template:El: Template:Argument

Specifies the dimension to clone the blocks to. If unspecified, defaults to current execution dimension.

Template:Arg desc

Template:Argument

Specifies the lower northwest corner of the destination region.

Template:Arg desc

Template:El: Template:Code and Template:Code
Template:El: Template:Argument

Specifies whether to filter the blocks being cloned. Must be one of the following:

replace — Copy all blocks, overwriting all blocks of the destination region with the blocks from the source region.
masked — Copy only non-air blocks. Blocks in the destination region that would otherwise be overwritten by air are left unmodified.

If unspecified, defaults to replace.

Template:El：Template:Cd

Makes the command place blocks as-is without triggering block updates and shape updates.

Template:El: Template:Code
Template:El: Template:Argument

Specifies how to treat the source region. Must be one of the following:

force — Force the clone even if the source and destination regions overlap.
move — Clone the source region to the destination region, then replace the source region with air. When used in filtered mask mode, only the cloned blocks are replaced with air.
normal — Don't move or force.

If unspecified, defaults to normal.

Template:Argument

Specifies the block id to copy in filtered mode.

Template:Arg desc

Template:El: Template:Argument

Specifies the Minecraft:block states to use for the block.

Template:Arg desc

Result

Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table

Output

Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table

History

Java Edition

Template:HistoryTable

Bedrock Edition

Template:HistoryTable

References

External links

Template:Cite

Navigation

Template:Navbox commands

Minecraft:de:Befehl/clone Minecraft:es:Comandos/clone Minecraft:ja:コマンド/clone Minecraft:ko:명령어/clone Minecraft:pt:Comandos/clone Minecraft:ru:Команды консоли/clone Minecraft:uk:Команди консолі/clone Minecraft:zh:命令/clone

@@ Line 4: / Line 4: @@
 * 2 {{only|java|short=1}}
 * 1 {{only|bedrock|short=1}}
-|others=Cheat only{{only|bedrock|short=1}}
+|others=[[Minecraft:Cheat]] only{{only|bedrock|short=1}}
 }}
@@ Line 68: / Line 68: @@
 == Arguments ==
-{{MC/El|je|short=1}}: {{MC/Argument|sourceDimension|dimension}}
+{{el|je|short=1}}: {{argument|sourceDimension|dimension}}
 : Specifies the dimension to clone the blocks from. If unspecified, defaults to current execution dimension.
-: {{MC/Arg desc|je=dimension}}
+: {{arg desc|je=dimension}}
-{{MC/El|je|short=1}}: {{MC/Argument|begin|block_pos}} and {{MC/Argument|end|block_pos}}<br>
+{{el|je|short=1}}: {{argument|begin|block_pos}} and {{argument|end|block_pos}}<br>
-{{MC/El|be|short=1}}: {{MC/Argument|be=1|begin: x y z|CommandPosition}} and {{MC/Argument|be=1|end: x y z|CommandPosition}}
+{{el|be|short=1}}: {{argument|be=1|begin: x y z|CommandPosition}} and {{argument|be=1|end: x y z|CommandPosition}}
 : Specifies the coordinates of two opposing corner blocks of the source region.
-: {{MC/Arg desc|je=block_pos|be=CommandPosition}}
+: {{arg desc|je=block_pos|be=CommandPosition}}
 : Block position is the coordinates of the point at the lower northwest corner of a block. Because of this, the lesser coordinates of each axis falls right on the region boundary, but the greater coordinates are one block from the boundary, and the block volume of the source region is (x<sub>greater</sub> - x<sub>lesser</sub> + 1) × (y<sub>greater</sub> - y<sub>lesser</sub> + 1) × (z<sub>greater</sub> - z<sub>lesser</sub> + 1). For example, <code>0 0 0 0 0 0</code> has a 1-block volume, and <code>0 0 0 1 1 1</code> and <code>1 1 1 0 0 0</code> both identify the same region with an 8-block volume.
-{{MC/El|je|short=1}}: {{MC/Argument|targetDimension|dimension}}
+{{el|je|short=1}}: {{argument|targetDimension|dimension}}
 : Specifies the dimension to clone the blocks to. If unspecified, defaults to current execution dimension.
-: {{MC/Arg desc|je=dimension}}
+: {{arg desc|je=dimension}}
-{{MC/Argument|destination|block_pos|destination: x y z|CommandPosition}}
+{{argument|destination|block_pos|destination: x y z|CommandPosition}}
 : Specifies the lower northwest corner of the destination region.
-: {{MC/Arg desc|je=block_pos|be=CommandPosition}}
+: {{arg desc|je=block_pos|be=CommandPosition}}
-{{MC/El|je|short=1}}: {{MC/Code|replace}} and {{MC/Code|masked}}<br>
+{{el|je|short=1}}: {{code|replace}} and {{code|masked}}<br>
-{{MC/El|be|short=1}}: {{MC/Argument|be=1|maskMode: MaskMode|enum}}
+{{el|be|short=1}}: {{argument|be=1|maskMode: MaskMode|enum}}
 : Specifies whether to filter the blocks being cloned. Must be one of the following:
 :* <code>replace</code> — Copy all blocks, overwriting ''all'' blocks of the destination region with the blocks from the source region.
@@ Line 93: / Line 93: @@
 : If unspecified, defaults to <code>replace</code>.
-{{MC/El|je|short=1}}：{{MC/Cd|strict}}
+{{el|je|short=1}}：{{cd|strict}}
 : Makes the command place blocks as-is without triggering block updates and shape updates.
-{{MC/El|je|short=1}}: {{code|force{{!}}move{{!}}normal}}<br>
+{{el|je|short=1}}: {{code|force{{!}}move{{!}}normal}}<br>
-{{MC/El|be|short=1}}: {{MC/Argument|be=1|cloneMode: CloneMode|enum}}
+{{el|be|short=1}}: {{argument|be=1|cloneMode: CloneMode|enum}}
 : Specifies how to treat the source region. Must be one of the following:
 :* <code>force</code> — Force the clone even if the source and destination regions overlap.
@@ Line 104: / Line 104: @@
 : If unspecified, defaults to <code>normal</code>.
-{{MC/Argument|filter|block_predicate|tileName: Block|enum}}
+{{argument|filter|block_predicate|tileName: Block|enum}}
 : Specifies the block id to copy in <code>filtered</code> mode.
-: {{MC/Arg desc|je=block_predicate|be=Block}}
+: {{arg desc|je=block_predicate|be=Block}}
-{{MC/El|be|short=1}}: {{MC/Argument|be=1|blockStates: block states|BlockStateCommandParam}}
+{{el|be|short=1}}: {{argument|be=1|blockStates: block states|BlockStateCommandParam}}
-: Specifies the block states to use for the block.
+: Specifies the [[Minecraft:block states]] to use for the block.
-: {{MC/Arg desc|be=BlockStateCommandParam}}
+: {{Arg desc|be=BlockStateCommandParam}}
 == Result ==
@@ Line 131: / Line 131: @@
 == Output ==
-{{MC/Output table}}
+{{Output table}}
-{{MC/Output table|edition=je|On fail|0|0|0}}
+{{Output table|edition=je|On fail|0|0|0}}
-{{MC/Output table|On success|1|1|the number of blocks that are successfully cloned.}}
+{{Output table|On success|1|1|the number of blocks that are successfully cloned.}}
-{{MC/Output table|edition=be|On fail|0}}
+{{Output table|edition=be|On fail|0}}
-{{MC/Output table|On success|1}}
+{{Output table|On success|1}}
-{{MC/Output table}}
+{{Output table}}
 == History ==
-{{MC/Expand section}}
 === ''Java Edition'' ===
 {{HistoryTable
-|{{MC/HistoryLine|java}}
+|{{HistoryLine|java}}
-|{{HistoryLine||1.8|dev=14w03a|Added {{MC/Cmd|clone|link=none}}.}}
+|{{HistoryLine||1.8|dev=14w03a|Added {{cmd|clone|link=none}}.}}
-|{{HistoryLine|||dev=14w10a|Added {{MC/Cd|force}} option.}}
+|{{HistoryLine|||dev=14w10a|Added {{cd|force}} option.}}
-|{{HistoryLine|||dev=14w20a|Added {{MC/Cd|move}} option.}}
+|{{HistoryLine|||dev=14w20a|Added {{cd|move}} option.}}
 |{{HistoryLine||1.13|dev=17w45a|
 The syntax of /clone has been changed.|
   {{cmd|clone <begin> <end> <destination> filtered [force{{!}}move{{!}}normal] [<block>] [<data>]|link=none}} becomes {{cmd|clone <begin> <end> <destination> filtered [<block>] [force{{!}}move{{!}}normal].|link=none}}|
   {{cmd|clone <begin> <end> <destination> [replace{{!}}masked] [force{{!}}move{{!}}normal] [<block>] [<data>]|link=none}} becomes {{cmd|clone <begin> <end> <destination> [replace{{!}}masked] [force{{!}}move{{!}}normal].|link=none}}}}
-|{{HistoryLine||1.19.4|dev=23w03a|Added {{MC/Cd|dimension}} argument.
+|{{HistoryLine||1.19.4|dev=23w03a|Added {{cd|dimension}} argument.
 |Now the limit volume of the clone region is controlled by <code>commandModificationBlockLimit</code> gamerule, instead of a hardcoded value 32768.}}
-|{{MC/HistoryLine||1.21.5|dev=25w02a|Accepts a new option: <code>strict</code>.|New syntax for commands to use the new strict option.}}
+|{{HistoryLine||1.21.5|dev=25w02a|Accepts a new option: <code>strict</code>.|New syntax for commands to use the new strict option.}}
 }}
 === ''Bedrock Edition'' ===
 {{HistoryTable
-|{{MC/HistoryLine|pocket alpha}}
+|{{HistoryLine|pocket alpha}}
-|{{HistoryLine||v0.16.0|dev=build 1|Added {{MC/Cmd|clone|link=none}}.|Functionality is almost equivalent to Java Edition 1.10 usage, except {{MC/Cmd|clone|link=none}} cannot use {{MC/Cd|forced}} cloneMode.}}
+|{{HistoryLine||v0.16.0|dev=build 1|Added {{cmd|clone|link=none}}.|Functionality is almost equivalent to [[Minecraft:Java Edition 1.10]] usage, except {{cmd|clone|link=none}} cannot use {{cd|forced}} cloneMode.}}
-|{{MC/HistoryLine|bedrock}}
+|{{HistoryLine|bedrock}}
-|{{HistoryLine||1.16.210|dev=beta 1.16.210.53|Added block state support to {{MC/Cmd|clone|link=none}}.}}
+|{{HistoryLine||1.16.210|dev=beta 1.16.210.53|Added [[Minecraft:block state]] support to {{cmd|clone|link=none}}.}}
-|{{MC/HistoryLine|||dev=beta 1.16.210.57|Cloning a block of the same type is no longer treated as a failed operation.}}
+|{{HistoryLine|||dev=beta 1.16.210.57|Cloning a block of the same type is no longer treated as a failed operation.}}
-|{{HistoryLine||1.18.0|dev=?|The limit volume of {{MC/Cmd|clone|link=none}} is 655360 now, instead of 524288.}}
+|{{HistoryLine||1.18.0|dev=?|The limit volume of {{cmd|clone|link=none}} is 655360 now, instead of 524288.}}
-|{{MC/HistoryLine||1.19.70|dev=Preview 1.19.70.21|Removed <code>tileData: int</code> argument.}}
+|{{HistoryLine||1.19.70|dev=Preview 1.19.70.21|Removed <code>tileData: int</code> argument.}}
-|{{MC/HistoryLine||1.21.0|dev=Preview 1.21.0.20|Containers being cloned over no longer keep their container screens open.}}
+|{{HistoryLine||1.21.0|dev=Preview 1.21.0.20|Containers being cloned over no longer keep their container screens open.}}
 }}
@@ Line 172: / Line 170: @@
 == See also ==
-: {{MC/Cmd|fill}} – fill a region with a block.
+: {{cmd|fill}} – fill a region with a block.
 == External links ==
@@ Line 179: / Line 177: @@
 == Navigation ==
-{{MC/Navbox commands}}
+{{Navbox commands}}
-de:Befehl/clone
+[[Minecraft:de:Befehl/clone]]
-es:Comandos/clone
+[[Minecraft:es:Comandos/clone]]
-ja:コマンド/clone
+[[Minecraft:ja:コマンド/clone]]
-ko:명령어/clone
+[[Minecraft:ko:명령어/clone]]
-pt:Comandos/clone
+[[Minecraft:pt:Comandos/clone]]
-ru:Команды консоли/clone
+[[Minecraft:ru:Команды консоли/clone]]
-uk:Команди консолі/clone
+[[Minecraft:uk:Команди консолі/clone]]
-zh:命令/clone
+[[Minecraft:zh:命令/clone]]