Commands/setblock

setblock

Permission level required	2‌[JE only] 1‌[BE only]
Restrictions	Cheat only‌[BE only]

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.

BE: tileData: int: int

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 must 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
/setblock ... keep	try to change a non-air block		Failed
/setblock ... keep /setblock ... replace	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.

Commands

View at: Template:Commands/content [edit]