Minecraft:Commands/setblock - Revision history

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T20:13:29Z

Fix template calls: add MC/ prefix

← Older revision		Revision as of 20:13, 9 April 2026
Line 16:		Line 16:

	== Arguments ==		== Arguments ==
	{{~~argument~~\|pos\|block_pos\|position: x y z\|CommandPosition}}		{{MC/Argument\|pos\|block_pos\|position: x y z\|CommandPosition}}
	: Specifies the position of the block to be changed.		: Specifies the position of the block to be changed.
	: {{~~arg~~ desc\|je=block_pos\|be=CommandPosition}}		: {{MC/Arg desc\|je=block_pos\|be=CommandPosition}}

	{{~~argument~~\|block\|block_state\|tileName: Block\|enum}}		{{MC/Argument\|block\|block_state\|tileName: Block\|enum}}
	: Specifies the new block.		: Specifies the new block.
	: {{~~arg~~ desc\|je=block_state\|be=Block}}		: {{MC/Arg desc\|je=block_state\|be=Block}}

	{{el\|be\|short=1}}: {{~~argument~~\|be=1\|blockStates: block states\|BlockStateCommandParam}}		{{MC/El\|be\|short=1}}: {{MC/Argument\|be=1\|blockStates: block states\|BlockStateCommandParam}}
	: Specifies the block states to use for the block.		: Specifies the block states to use for the block.
	: {{Arg desc\|be=BlockStateCommandParam}}		: {{MC/Arg desc\|be=BlockStateCommandParam}}

	{{code\|destroy{{!}}keep{{!}}replace}} and {{code\|destroy{{!}}keep{{!}}replace{{!}}strict}}		{{code\|destroy{{!}}keep{{!}}replace}} and {{code\|destroy{{!}}keep{{!}}replace{{!}}strict}}
Line 50:		Line 50:
	== Output ==		== Output ==

	{{Output table}}		{{MC/Output table}}
	{{Output table\|edition=je\|On fail\|0\|0\|0}}		{{MC/Output table\|edition=je\|On fail\|0\|0\|0}}
	{{Output table\|On success\|1\|1\|1}}		{{MC/Output table\|On success\|1\|1\|1}}
	{{Output table\|edition=be\|On fail\|0}}		{{MC/Output table\|edition=be\|On fail\|0}}
	{{Output table\|On success\|1}}		{{MC/Output table\|On success\|1}}
	{{Output table}}		{{MC/Output table}}

	== Examples ==		== Examples ==
Line 61:		Line 61:
	** <code>setblock ~ ~ ~ chest[facing=east]</code>{{only\|java}}		** <code>setblock ~ ~ ~ chest[facing=east]</code>{{only\|java}}
	** <code>setblock ~ ~ ~ chest ["minecraft:cardinal_direction"="east"]</code>{{only\|bedrock}}		** <code>setblock ~ ~ ~ chest ["minecraft:cardinal_direction"="east"]</code>{{only\|bedrock}}
	* Place a sign next to it {{in\|java}}		* Place a sign next to it {{MC/In\|java}}
	** <code>setblock ~ ~ ~-1 birch_sign{Text1:'"My chest"',Text2:'"Do not open!"'}</code> (Note the two sets of quotes around the text. They are required.)		** <code>setblock ~ ~ ~-1 birch_sign{Text1:'"My chest"',Text2:'"Do not open!"'}</code> (Note the two sets of quotes around the text. They are required.)
	* Put a top quartz slab at the top of your head		* Put a top quartz slab at the top of your head
Line 70:		Line 70:
	=== ''Java Edition'' ===		=== ''Java Edition'' ===
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java}}		\|{{MC/HistoryLine\|java}}
	\|{{HistoryLine\|\|1.7.2\|dev=13w37a\|Added {{~~cmd~~\|setblock\|link=none}}.}}		\|{{HistoryLine\|\|1.7.2\|dev=13w37a\|Added {{MC/Cmd\|setblock\|link=none}}.}}
	\|{{HistoryLine\|\|1.11\|dev=16w32a\|Added block state support to {{~~cmd~~\|setblock\|link=none}}.}}		\|{{HistoryLine\|\|1.11\|dev=16w32a\|Added block state support to {{MC/Cmd\|setblock\|link=none}}.}}
	\|{{HistoryLine\|\|1.16\|dev=20w06a\|{{cd\|/setblock ~ ~ ~ air destroy}} now can destroy liquids.<ref>{{bug\|MC-163286\|resolution=Fixed}}</ref>}}		\|{{HistoryLine\|\|1.16\|dev=20w06a\|{{MC/Cd\|/setblock ~ ~ ~ air destroy}} now can destroy liquids.<ref>{{bug\|MC-163286\|resolution=Fixed}}</ref>}}
	\|{{HistoryLine\|\|1.21.5\|dev=25w02a\|The behavior of {{~~cmd~~\|setblock}} command has changed in how it handles block entity data.\|Accepts a new option: <code>strict</code>.\|New syntax for commands to use the new strict option.}}		\|{{HistoryLine\|\|1.21.5\|dev=25w02a\|The behavior of {{MC/Cmd\|setblock}} command has changed in how it handles block entity data.\|Accepts a new option: <code>strict</code>.\|New syntax for commands to use the new strict option.}}
	}}		}}

	=== ''Bedrock Edition'' ===		=== ''Bedrock Edition'' ===
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|pocket alpha}}		\|{{MC/HistoryLine\|pocket alpha}}
	\|{{HistoryLine\|\|v0.16.0\|dev=build 1\|Added {{~~cmd~~\|setblock\|link=none}}.}}		\|{{HistoryLine\|\|v0.16.0\|dev=build 1\|Added {{MC/Cmd\|setblock\|link=none}}.}}
	\|{{HistoryLine\|bedrock}}		\|{{MC/HistoryLine\|bedrock}}
	\|{{HistoryLine\|\|1.16.210\|dev=beta 1.16.210.53\|Added block state support to {{~~cmd~~\|setblock\|link=none}}.}}		\|{{HistoryLine\|\|1.16.210\|dev=beta 1.16.210.53\|Added block state support to {{MC/Cmd\|setblock\|link=none}}.}}
	\|{{HistoryLine\|\|1.19.70\|dev=Preview 1.19.70.21\|Removed <code>tileData: int</code> argument.}}		\|{{MC/HistoryLine\|\|1.19.70\|dev=Preview 1.19.70.21\|Removed <code>tileData: int</code> argument.}}
	}}		}}

	== See also ==		== See also ==
	* {{~~cmd~~\|data}} — modifies the data tags of a block or entity		* {{MC/Cmd\|data}} — modifies the data tags of a block or entity
	* {{~~cmd~~\|clone}} — copies blocks from one region to another		* {{MC/Cmd\|clone}} — copies blocks from one region to another
	* {{~~cmd~~\|fill}} — fills a region with a block		* {{MC/Cmd\|fill}} — fills a region with a block

	== References ==		== References ==
Line 99:		Line 99:

	== Navigation ==		== Navigation ==
	{{Navbox commands}}		{{MC/Navbox commands}}

	de:Befehl/setblock		de:Befehl/setblock

SyncBot: Remove broken links to missing pages

2026-04-09T15:45:17Z

Remove broken links to missing pages

← Older revision		Revision as of 15:45, 9 April 2026
Line 4:		Line 4:
	* 2 {{only\|java\|short=1}}		* 2 {{only\|java\|short=1}}
	* 1 {{only\|bedrock\|short=1}}		* 1 {{only\|bedrock\|short=1}}
	\|others=~~[[Minecraft:~~Cheat]] only{{only\|bedrock\|short=1}}		\|others=Cheat only{{only\|bedrock\|short=1}}
	}}		}}
	Changes a [[Minecraft:block]] to another block.		Changes a [[Minecraft:block]] to another block.
Line 25:		Line 25:

	{{el\|be\|short=1}}: {{argument\|be=1\|blockStates: block states\|BlockStateCommandParam}}		{{el\|be\|short=1}}: {{argument\|be=1\|blockStates: block states\|BlockStateCommandParam}}
	: Specifies the ~~[[Minecraft:~~block states]] to use for the block.		: Specifies the block states to use for the block.
	: {{Arg desc\|be=BlockStateCommandParam}}		: {{Arg desc\|be=BlockStateCommandParam}}

	{{code\|destroy{{!}}keep{{!}}replace}} and {{code\|destroy{{!}}keep{{!}}replace{{!}}strict}}		{{code\|destroy{{!}}keep{{!}}replace}} and {{code\|destroy{{!}}keep{{!}}replace{{!}}strict}}
	: Specifies how to handle the block change. Must be one of:		: Specifies how to handle the block change. Must be one of:
	:* <code>destroy</code> — The old block ~~[[Minecraft:~~drops]] both itself and its contents (as if destroyed by a ~~[[Minecraft:~~player]]). Plays the appropriate block breaking noise.		:* <code>destroy</code> — The old block drops both itself and its contents (as if destroyed by a player). Plays the appropriate block breaking noise.
	:* <code>keep</code> — Only [[Minecraft:air]] blocks are changed (non-air blocks are unchanged).		:* <code>keep</code> — Only [[Minecraft:air]] blocks are changed (non-air blocks are unchanged).
	:* <code>replace</code> — The old block drops neither itself nor any contents. Plays no sound.		:* <code>replace</code> — The old block drops neither itself nor any contents. Plays no sound.
Line 41:		Line 41:
	{{Result table\|The command is incomplete, or any argument is not specified correctly.\|unparseable\|unparseable}}		{{Result table\|The command is incomplete, or any argument is not specified correctly.\|unparseable\|unparseable}}
	{{Result table\|The specified position is unloaded or out of the world.\|fail\|fail}}		{{Result table\|The specified position is unloaded or out of the world.\|fail\|fail}}
	{{Result table\|Trying to place block in ~~[[Minecraft:~~debug mode]].\|\|N/A}}		{{Result table\|Trying to place block in debug mode.\|\|N/A}}
	{{Result table\|cmd=/setblock ... keep\|Trying to change a non-air block.\|\|fail}}		{{Result table\|cmd=/setblock ... keep\|Trying to change a non-air block.\|\|fail}}
	{{Result table\|cmd=/setblock ... keep<br>/setblock ... replace<br>/setblock ... strict\|Trying to replace a block with an identical copy (ignoring the block entity).}}		{{Result table\|cmd=/setblock ... keep<br>/setblock ... replace<br>/setblock ... strict\|Trying to replace a block with an identical copy (ignoring the block entity).}}
Line 72:		Line 72:
	\|{{HistoryLine\|java}}		\|{{HistoryLine\|java}}
	\|{{HistoryLine\|\|1.7.2\|dev=13w37a\|Added {{cmd\|setblock\|link=none}}.}}		\|{{HistoryLine\|\|1.7.2\|dev=13w37a\|Added {{cmd\|setblock\|link=none}}.}}
	\|{{HistoryLine\|\|1.11\|dev=16w32a\|Added ~~[[Minecraft:~~block state]] support to {{cmd\|setblock\|link=none}}.}}		\|{{HistoryLine\|\|1.11\|dev=16w32a\|Added block state support to {{cmd\|setblock\|link=none}}.}}
	\|{{HistoryLine\|\|1.16\|dev=20w06a\|{{cd\|/setblock ~ ~ ~ air destroy}} now can destroy liquids.<ref>{{bug\|MC-163286\|resolution=Fixed}}</ref>}}		\|{{HistoryLine\|\|1.16\|dev=20w06a\|{{cd\|/setblock ~ ~ ~ air destroy}} now can destroy liquids.<ref>{{bug\|MC-163286\|resolution=Fixed}}</ref>}}
	\|{{HistoryLine\|\|1.21.5\|dev=25w02a\|The behavior of {{cmd\|setblock}} command has changed in how it handles block entity data.\|Accepts a new option: <code>strict</code>.\|New syntax for commands to use the new strict option.}}		\|{{HistoryLine\|\|1.21.5\|dev=25w02a\|The behavior of {{cmd\|setblock}} command has changed in how it handles block entity data.\|Accepts a new option: <code>strict</code>.\|New syntax for commands to use the new strict option.}}
Line 82:		Line 82:
	\|{{HistoryLine\|\|v0.16.0\|dev=build 1\|Added {{cmd\|setblock\|link=none}}.}}		\|{{HistoryLine\|\|v0.16.0\|dev=build 1\|Added {{cmd\|setblock\|link=none}}.}}
	\|{{HistoryLine\|bedrock}}		\|{{HistoryLine\|bedrock}}
	\|{{HistoryLine\|\|1.16.210\|dev=beta 1.16.210.53\|Added ~~[[Minecraft:~~block state]] support to {{cmd\|setblock\|link=none}}.}}		\|{{HistoryLine\|\|1.16.210\|dev=beta 1.16.210.53\|Added block state support to {{cmd\|setblock\|link=none}}.}}
	\|{{HistoryLine\|\|1.19.70\|dev=Preview 1.19.70.21\|Removed <code>tileData: int</code> argument.}}		\|{{HistoryLine\|\|1.19.70\|dev=Preview 1.19.70.21\|Removed <code>tileData: int</code> argument.}}
	}}		}}
Line 101:		Line 101:
	{{Navbox commands}}		{{Navbox commands}}

	~~[[Minecraft:~~de:Befehl/setblock]]		de:Befehl/setblock
	~~[[Minecraft:~~ja:コマンド/setblock]]		ja:コマンド/setblock
	~~[[Minecraft:~~pt:Comandos/setblock]]		pt:Comandos/setblock
	~~[[Minecraft:~~ru:Команды консоли/setblock]]		ru:Команды консоли/setblock
	~~[[Minecraft:~~uk:Команди консолі/setblock]]		uk:Команди консолі/setblock
	~~[[Minecraft:~~zh:命令/setblock]]		zh:命令/setblock

imported>MinecraftBedrockPlayer7 at 17:04, 20 November 2025

2025-11-20T17:04:17Z

New page

{{Infobox command
|name=setblock
|oplevel=
* 2 {{only|java|short=1}}
* 1 {{only|bedrock|short=1}}
|others=[[Minecraft:Cheat]] only{{only|bedrock|short=1}}
}}
Changes a [[Minecraft:block]] to another block.

== Syntax ==
* '''Java Edition'''
: <code>setblock <pos> <block> [destroy|keep|replace|strict]</code>
* '''Bedrock Edition'''
: <code>setblock <position: x y z> <tileName: Block> <blockStates: block states> [destroy|keep|replace]</code>
: <code>setblock <position: x y z> <tileName: Block> [destroy|keep|replace]</code>

== Arguments ==
{{argument|pos|block_pos|position: x y z|CommandPosition}}
: Specifies the position of the block to be changed.
: {{arg desc|je=block_pos|be=CommandPosition}}

{{argument|block|block_state|tileName: Block|enum}}
: Specifies the new block.
: {{arg desc|je=block_state|be=Block}}

{{el|be|short=1}}: {{argument|be=1|blockStates: block states|BlockStateCommandParam}}
: Specifies the [[Minecraft:block states]] to use for the block.
: {{Arg desc|be=BlockStateCommandParam}}

{{code|destroy{{!}}keep{{!}}replace}} and {{code|destroy{{!}}keep{{!}}replace{{!}}strict}}
: Specifies how to handle the block change. Must be one of:
:* <code>destroy</code> — The old block [[Minecraft:drops]] both itself and its contents (as if destroyed by a [[Minecraft:player]]). Plays the appropriate block breaking noise.
:* <code>keep</code> — Only [[Minecraft:air]] blocks are changed (non-air blocks are unchanged).
:* <code>replace</code> — The old block drops neither itself nor any contents. Plays no sound.
:* <code>strict</code> — Place blocks as-is without triggering block updates and shape updates.
: If not specified, defaults to <code>replace</code>.

== Result ==

{{Result table}}
{{Result table|The command is incomplete, or any argument is not specified correctly.|unparseable|unparseable}}
{{Result table|The specified position is unloaded or out of the world.|fail|fail}}
{{Result table|Trying to place block in [[Minecraft:debug mode]].||N/A}}
{{Result table|cmd=/setblock ... keep|Trying to change a non-air block.||fail}}
{{Result table|cmd=/setblock ... keep<br>/setblock ... replace<br>/setblock ... strict|Trying to replace a block with an identical copy (ignoring the block entity).}}
{{Result table|Trying 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)<ref>{{bug|MC-255198}}</ref>.||success}}
{{Result table|cmd=|succeed}}
{{Result table}}

== Output ==

{{Output table}}
{{Output table|edition=je|On fail|0|0|0}}
{{Output table|On success|1|1|1}}
{{Output table|edition=be|On fail|0}}
{{Output table|On success|1}}
{{Output table}}

== Examples ==
* Put a chest facing east at your feet
** <code>setblock ~ ~ ~ chest[facing=east]</code>{{only|java}}
** <code>setblock ~ ~ ~ chest ["minecraft:cardinal_direction"="east"]</code>{{only|bedrock}}
* Place a sign next to it {{in|java}}
** <code>setblock ~ ~ ~-1 birch_sign{Text1:'"My chest"',Text2:'"Do not open!"'}</code> (Note the two sets of quotes around the text. They are required.)
* Put a top quartz slab at the top of your head
** <code>setblock ~ ~2 ~ quartz_slab[type=top]</code>{{only|java}}
** <code>setblock ~ ~2 ~ quartz_slab ["minecraft:vertical_half"="top"]</code>{{only|bedrock}}

== History ==
=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.7.2|dev=13w37a|Added {{cmd|setblock|link=none}}.}}
|{{HistoryLine||1.11|dev=16w32a|Added [[Minecraft:block state]] support to {{cmd|setblock|link=none}}.}}
|{{HistoryLine||1.16|dev=20w06a|{{cd|/setblock ~ ~ ~ air destroy}} now can destroy liquids.<ref>{{bug|MC-163286|resolution=Fixed}}</ref>}}
|{{HistoryLine||1.21.5|dev=25w02a|The behavior of {{cmd|setblock}} command has changed in how it handles block entity data.|Accepts a new option: <code>strict</code>.|New syntax for commands to use the new strict option.}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|pocket alpha}}
|{{HistoryLine||v0.16.0|dev=build 1|Added {{cmd|setblock|link=none}}.}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.16.210|dev=beta 1.16.210.53|Added [[Minecraft:block state]] support to {{cmd|setblock|link=none}}.}}
|{{HistoryLine||1.19.70|dev=Preview 1.19.70.21|Removed <code>tileData: int</code> argument.}}
}}

== See also ==
* {{cmd|data}} — modifies the data tags of a block or entity
* {{cmd|clone}} — copies blocks from one region to another
* {{cmd|fill}} — fills a region with a block

== References ==
<references/>

== External links ==

* {{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/commands/commands/setblock?view=minecraft-bedrock-stable|title=<code>/setblock</code> Command|website=Microsoft Learn|date=June 17, 2024}}

== Navigation ==
{{Navbox commands}}

[[Minecraft:de:Befehl/setblock]]
[[Minecraft:ja:コマンド/setblock]]
[[Minecraft:pt:Comandos/setblock]]
[[Minecraft:ru:Команды консоли/setblock]]
[[Minecraft:uk:Команди консолі/setblock]]
[[Minecraft:zh:命令/setblock]]