Minecraft:Commands/clone

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