Editing MinecraftCommands (section)

=== clone ===

{{/infobox
|clone
|op
|1.8|14w03a
}}

Clones blocks from one region to another.

;Syntax

: <code>clone <span style="background-color:#FDD"><''x1''> <''y1''> <''z1''></span> <span style="background-color:#FFD"><''x2''> <''y2''> <''z2''></span> <span style="background-color:#DDF"><''x''> <''y''> <''z''></span> [''maskMode''] [''cloneMode''] [''TileName'']</code>

:''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

: <span style="background-color:#FDD">''x1 y1 z1''</span> and <span style="background-color:#FFD">''x2 y2 z2''</span>
:: Specifies the coordinates of two opposing corner blocks of the source region. May use [[#Tilde notation|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 (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.

: <span style="background-color:#DDF">''x y z''</span>
:: Specifies the lower northwest corner (i.e., the smallest coordinates of each axis) of the destination region. May use [[#Tilde notation|tilde notation]] to specify a distance relative to the command's execution.

: ''maskMode'' (optional)
:: Specifies whether to filter the blocks being cloned. Must be one of the following:
::* <code>filtered</code> — Clone only blocks with the block id specified by ''TileName''.
::* <code>masked</code> — Copy only non-air blocks. Blocks in the destination region that would otherwise be overwritten by air are left unmodified.
::* <code>replace</code> — Copy all blocks, overwriting ''all'' blocks of the destination region with the blocks from the source region.
:: If left unspecified, defaults to <code>replace</code>.

: ''cloneMode'' (optional)
:: 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.
::* <code>move</code> — 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.
::* <code>normal</code> — Don't move or force.
:: If left unspecified, defaults to <code>normal</code>.

: ''TileName'' (optional)
:: Specifies the block id (e.g., <code>minecraft:stone</code>) to copy when ''maskMode'' is set to <code>filtered</code>. Not optional when using <code>filtered</code> mode.

;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

: {{cmd|fill}} — fill a region with a block


<!-- please retain double newline above for section differentiation -->