/setblock

{
    "title": "<code>/setblock</code>",
    "rows": [
        {
            "field": "\n* 2 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Java Edition\">(link to Java Edition article, displayed as JE)  only</span></i>]</sup>\n* 1 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE)  only</span></i>]</sup>",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "(link to Options article, displayed as Cheat) only‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE)  only</span></i>]</sup>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Changes a block to another block.

Syntax

• Java Edition

setblock <pos> <block> [destroy|keep|replace|strict]

• Bedrock Edition

setblock <position: x y z> <tileName: Block> <blockStates: block states> [destroy|keep|replace]

setblock <position: x y z> <tileName: Block> [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, 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, must be a three-dimensional coordinates composed of <X>, <Y> and <Z>, each of which must be a single-precision floating-point number or tilde and caret notation.

JE: <block>: block_state
BE: tileName: Block: enum

Specifies the new block.

In Java Edition, must be in the format 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, must be a block id.

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 and destroy|keep|replace|strict

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.
• strict — Place blocks as-is without triggering block updates and shape updates.

If not specified, defaults to replace.

Result

Output

Examples

• Put a chest facing east at your feet
  • setblock ~ ~ ~ chest[facing=east]‌
  • setblock ~ ~ ~ chest ["minecraft:cardinal_direction"="east"]‌
• 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]‌
  • setblock ~ ~2 ~ quartz_slab ["minecraft:vertical_half"="top"]‌

History

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

References

Navigation