Commands/setblock

From Minecraft Wiki
Jump to: navigation, search
setblock
Restrictions

Operator

First introduced

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

Changes a block to another block.

Syntax
  • Java Edition
setblock <pos> <block> [<mode>]
setblock <pos> <block>[state=value] [<mode>]
where state is the name of the block state, and value is that block state's value (see Block states). Multiple block states and their values can be included, separated by a comma. (For example, minecraft:furnace[lit=true,facing=south])
  • Bedrock Edition
setblock <position: x y z> <tileName: Block> [tileData: int] [replace|destroy|keep]
Arguments
x y z (BE: position: x y z)
Specifies the position of the block to be changed. May use tilde notation to specify a position relative to the command's execution.
block (BE: tileName: Block)
Specifies the new block. Must be a block id (for example, minecraft:stone or stone).
tileData: int (optional)[Bedrock Edition only]
Specifies additional data to further describe the new block. Must be between 0 and 15 (inclusive). If not specified, defaults to 0.
oldBlockHandling or mode (BE: replace|destroy|keep) (optional)
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 will be changed (non-air blocks will be "kept").
  • replace — The old block drops neither itself nor any contents. Plays no sound.
If not specified, defaults to replace.
Result
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
  • /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


Promotional Content