Commands/clone

From Minecraft Wiki
Jump to: navigation, search
clone
Restrictions

Operator

First introduced

1.8 (14w03a)
PE Alpha 0.16.0 (PE Alpha 0.16.0 build 1)

Clones blocks from one region to another.

Syntax
  • Java Edition
clone <x1> <y1> <z1> <x2> <y2> <z2> <x> <y> <z> [maskMode] [cloneMode] [TileName] [dataValue|state]
  • Pocket Edition
clone <begin: x y z> <end: x y z> <destination: x y z> [maskMode: string] [cloneMode: string] [tileName: string] [tileData: int]
Color added to make reading easier. The in-game help for the clone command does not list the final argument — TileName is a placeholder name for the purpose of discussion.
Arguments
x1 y1 z1 and x2 y2 z2 (PE: begin: x y z and end: x y z)
Specifies the coordinates of two opposing corner blocks of the source region. May use tilde notation to specify distances relative to the command's execution.
The blocks that make up the corners extend in the positive direction from the coordinates used to identify them. Because of this, the lesser coordinates of each axis will be right on the region boundary, but the greater coordinates will be one block from the boundary, and the block volume of the source region will be (xgreater - xlesser + 1) × (ygreater - ylesser + 1) × (zgreater - zlesser + 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.
x y z (PE: destination: x y z)
Specifies the lower northwest corner (i.e., the smallest coordinates of each axis) of the destination region. May use tilde notation to specify a distance relative to the command's execution.
maskMode (PE: maskMode: string) (optional)
Specifies whether to filter the blocks being cloned. Must be one of the following:
  • filtered — Clone only blocks with the block id specified by TileName.
  • masked — Copy only non-air blocks. Blocks in the destination region that would otherwise be overwritten by air are left unmodified.
  • replace — Copy all blocks, overwriting all blocks of the destination region with the blocks from the source region.
If left unspecified, defaults to replace.
cloneMode (PE: cloneMode: string) (optional)
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 will be replaced with air.
  • normal — Don't move or force.
If left unspecified, defaults to normal.
TileName (PE: tileName: string) (optional)
Specifies the block id (e.g., minecraft:stone) to copy when maskMode is set to filtered. Not optional when using filtered mode.
dataValue (PE: tileData: int) (optional)
Specifies the block data to match when finding blocks to clone. Must be between 0 and 15 (inclusive).
state (optional)[Java Edition only]
Specifies the block state to match when finding blocks to clone. Must be a valid block state for the block specified in block.
Result
Fails if the arguments are not specified correctly, if the block volume of the source region is greater than 32768 (enough for the equivalent of eight chunk sections), if the source and destination region overlap (unless using force clone mode), or if one or both regions isn't currently rendered.
On success, overwrites blocks in the destination region with blocks from the source region, leaving the source region unmodified (unless using move clone mode).
See also
/fill — fill a region with a block