Commands/setblock

From Minecraft Wiki
Jump to: navigation, search
setblock
Restrictions

Operator

First introduced

Java Edition 1.7.2 (13w37a)
PE Alpha 0.16.0 (PE Alpha 0.16.0 build 1)

Changes a block to another block.

Syntax[edit]

  • Java Edition
setblock <pos> <block> [destroy|keep|replace]
  • Bedrock Edition
setblock <position: x y z> <tileName: Block> [tileData: int] [destroy|keep|replace]

Arguments[edit]

<pos> (BE: position: x y z)

Specifies the position of the block to be changed. May use tilde and caret notation to specify a position relative to the command's execution.

<block> (BE: tileName: Block)

Specifies the new block. Must be a block id.

tileData: int[Bedrock Edition only]

Specifies additional data to further describe the new block. Must be between 0 and 65535 (inclusive), but values that are invalid for the specified block id revert to 0. If not specified, defaults to 0.

destroy|keep|replace

Specifies how to handle the block change. Must be one of:
  • destroy — The old block drops both itself and its contents (as if destroyed by a player). Plays the appropriate block breaking noise.
  • keep — Only air blocks are changed (non-air blocks are unchanged).
  • replace — The old block drops neither itself nor any contents. Plays no sound.
If not specified, defaults to replace.

Result[edit]

Fails if the arguments are not specified correctly, if tried to change a non-air block in keep mode, tried to replace a block with an identical copy in keep or replace mode, or if the coordinates are in an unloaded chunk.

On success, changes the block at the specified position.

See also[edit]

  • /data — modifies the data tags of a block or entity
  • /clone — copies blocks from one region to another
  • /fill — fills a region with a block

History[edit]

Java Edition
1.7.213w37aAdded /setblock.
1.1116w32aAdded block state support to /setblock.
Pocket Edition Alpha
0.16.0build 1Added /setblock.