setblock
| Permission level required |
|
|---|---|
| Restrictions |
Changes a block to another block.
Syntax[]
- Java Edition
setblock <pos> <block> [destroy|keep|replace]
- Bedrock Edition
setblock <position: x y z> <tileName: Block> [tileData: int] [destroy|keep|replace]setblock <position: x y z> <tileName: Block> [blockStates: block states] [destroy|keep|replace]
Arguments[]
JE: <pos>: block_pos
BE: position: x y z: CommandPosition
- Specifies the position of the block to be changed.
- In Java Edition, it 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, it must be a three-dimensional coordinates composed of <x>, <y> and <z>, each of which must be a floating-point number or tilde and caret notation.
JE: <block>: block_state
BE: tileName: Block: enum
- Specifies the new block.
- In Java Edition, it must be in form of
block_id[block_states]{data_tags}(does not accept block tags), in which block states and data tags can be omitted when they are not needed. In Bedrock Edition, it must be a block id.
- Specifies the block data to use for the new block. Values that are invalid for the specified block id revert to 0. If not specified, defaults to 0.
- Must be a 32-bit integer number. It should be between 0 and 65535 (inclusive).
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].
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[]
| Command | Trigger | Java Edition | Bedrock Edition |
|---|---|---|---|
| any | the arguments are not specified correctly | Unparseable | Failed |
| specified position is unloaded or out of the world | Failed | ||
| try to place block in Debug mode | N/A | ||
tileData: int is lower than 0 or higher than 65535 | N/A | Failed | |
/setblock ... keep | try to change a non-air block | Failed | |
/setblock ... keep | try to replace a block with an identical copy (ignoring the block entity) | ||
| try to replace some kinds of redstone components with an unstable block (e.g. replacing one of two adjacent standing redstone torches with a TNT block) | Successful | ||
| any | On success | Changes blocks at the specified position. | |
Output[]
| Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| any | Java Edition | On fail | 0 | 0 | 0 |
| On success | 1 | 1 | 1 | ||
| Bedrock Edition | On fail | 0 | N/A | N/A | |
| On success | 1 | N/A | N/A |
Examples[]
- Put a chest facing east at your feet
setblock ~ ~ ~ chest[facing=east][Java Edition only]setblock ~ ~ ~ chest ["facing_direction":5][Bedrock Edition only]
- Place a sign next to it in Java Edition
setblock ~ ~ ~-1 birch_sign{Text1:'"My chest"',Text2:'"Do not open!"'}(Note the two sets of quotes around the text. They are required.)
- Put a top quartz slab at the top of your head
setblock ~ ~2 ~ quartz_slab[type=top][Java Edition only]setblock ~ ~2 ~ stone_slab ["stone_slab_type":"quartz","top_slot_bit":true][Bedrock Edition only]
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
History[]
| Java Edition | |||||
|---|---|---|---|---|---|
| 1.7.2 | 13w37a | Added /setblock. | |||
| 1.11 | 16w32a | Added block state support to /setblock. | |||
| Pocket Edition Alpha | |||||
| v0.16.0 | build 1 | Added /setblock. | |||
| Bedrock Edition | |||||
| 1.16.210 | beta 1.16.210.53 | Added block state support to /setblock. | |||
