/clone

{
    "title": "<code>/clone</code>",
    "rows": [
        {
            "field": "\n* 2 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Java Edition\">(link to Java Edition article, displayed as JE)  only</span></i>]</sup>\n* 1 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE)  only</span></i>]</sup>",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "(link to Options article, displayed as Cheat) only‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE)  only</span></i>]</sup>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Clones 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-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

JE: <sourceDimension>: dimension

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

It must be a resource location, which resolves into a dimension during command execution.

JE: <begin>: block_pos and <end>: block_pos
BE: begin: x y z: CommandPosition and end: x y z: CommandPosition

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

In Java Edition, must be a block position composed of <X>, <Y> and <Z>, each of which must be an integer or a tilde and caret notation. In Bedrock Edition, must be a three-dimensional coordinates composed of <X>, <Y> and <Z>, each of which must be a single-precision floating-point number or tilde and caret notation.

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.

JE: <targetDimension>: dimension

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

It must be a resource location, which resolves into a dimension during command execution.

JE: <destination>: block_pos
BE: destination: x y z: CommandPosition

Specifies the lower northwest corner of the destination region.

In Java Edition, must be a block position composed of <X>, <Y> and <Z>, each of which must be an integer or a tilde and caret notation. In Bedrock Edition, must be a three-dimensional coordinates composed of <X>, <Y> and <Z>, each of which must be a single-precision floating-point number or tilde and caret notation.

JE: replace and masked
BE: maskMode: MaskMode: enum

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.

JE：strict

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

JE: force|move|normal
BE: cloneMode: CloneMode: enum

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.

JE: <filter>: block_predicate
BE: tileName: Block: enum

Specifies the block id to copy in filtered mode.

In Java Edition, must be in the format of block_id[block_states]{data_tags}(accepts block tags), in which block states and data tags can be omitted when they are not needed. In Bedrock Edition, must be a block id.

BE: blockStates: block states: BlockStateCommandParam

Specifies the block states to use for the block.

Must be a blockstate argument as ["<state1>"=<value1>,"<state2>"=<value2>,...]. For example: ["old_leaf_type"="birch","persistent_bit"=true].

Result

Output

History

This section needs expansion.

 

You can help by expanding it.

References

See also

/fill – fill a region with a block.

Navigation