Minecraft:Commands/execute - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-18T11:09:58Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 18 October 2026
Line 431:		Line 431:
	# [[#ifunlesspredicate\|(if\|unless) predicate]] – Tests a [[Minecraft:predicate]]{{only\|java}}		# [[#ifunlesspredicate\|(if\|unless) predicate]] – Tests a [[Minecraft:predicate]]{{only\|java}}
	# [[#ifunlessscore\|(if\|unless) score]] - Tests a target's score		# [[#ifunlessscore\|(if\|unless) score]] - Tests a target's score
	# [[#~~ifunlessscore~~\|(if\|unless) stopwatch]] - Tests a stopwatch's elapsed time (in seconds) against a given value range.{{only\|java}}		# [[#ifunlessstopwatch\|(if\|unless) stopwatch]] - Tests a stopwatch's elapsed time (in seconds) against a given value range.{{only\|java}}

	{{anchor\|ifunlessbiome}}		{{anchor\|ifunlessbiome}}

SyncBot: Sync: updated from Minecraft

2026-10-07T11:08:18Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 7 October 2026
Line 975:		Line 975:

	== References ==		== References ==
	~~<references/>~~		{{Reflist}}

	== External links ==		== External links ==

SyncBot: Sync: updated from Minecraft

2026-10-02T11:04:29Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 2 October 2026
Line 180:		Line 180:
	: Sets the ''execution anchor'' to the eyes or feet. Defaults to feet.		: Sets the ''execution anchor'' to the eyes or feet. Defaults to feet.
	: Running <code>positioned <pos> -> execute</code> resets to feet.		: Running <code>positioned <pos> -> execute</code> resets to feet.
	: Effectively recenters [[Minecraft:local coordinates]] on either the eyes or feet, also changing the angle of the <code>facing</code> subcommand (of {{cmd\|~~execute\|link=none~~}} and {{cmd\|~~teleport~~}}) works off of.		: Effectively recenters [[Minecraft:local coordinates]] on either the eyes or feet, also changing the angle the <code>facing</code> subcommand (of {{Command\|rotate}}, {{cmd\|teleport}} and {{cmd\|execute\|link=none}}) works off of.
	: See also {{bug\|MCPE-162681}} and {{bug\|MCPE-165051}} for issues about {{el\|bedrock}}.		: See also {{bug\|MCPE-162681}} and {{bug\|MCPE-165051}} for issues about {{el\|bedrock}}.
	:;Syntax		:;Syntax

SyncBot: Sync: updated from Minecraft

2026-09-30T11:08:22Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 30 September 2026
Line 928:		Line 928:
	* Make a player say "My feet are soaked!" in chat if they are located in a block of [[Minecraft:water]]:		* Make a player say "My feet are soaked!" in chat if they are located in a block of [[Minecraft:water]]:
	*: <code>/execute as @a at @s if block ~ ~ ~ water run say "My feet are soaked!"</code>		*: <code>/execute as @a at @s if block ~ ~ ~ water run say "My feet are soaked!"</code>
	* Make a player say "Score is reset" in chat if the score <code>test</code> is not set, eg by doing "scoreboard players reset @s test":		* Make a player say "Score is reset" in chat if the score <code>test</code> is not set, e.g. by doing "scoreboard players reset @s test":
	*:<code>/execute as @a unless score @s test = @s test run say "Score is reset"</code>		*:<code>/execute as @a unless score @s test = @s test run say "Score is reset"</code>
	* Hurl all [[Minecraft:skeleton]]s skyward who are within 3 blocks of the nearest player:		* Hurl all [[Minecraft:skeleton]]s skyward who are within 3 blocks of the nearest player:

SyncBot: Sync: updated from Minecraft

2026-09-17T11:12:08Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:12, 17 September 2026
Line 652:		Line 652:
	::: Entity to test.		::: Entity to test.
	::: {{arg desc\|je=entity}}		::: {{arg desc\|je=entity}}
	~~:: {{Argument\|slots\|item_slots}}{{until\|JE 26.3}}~~
	:: {{Argument\|slots\|slot_source}}		:: {{Argument\|slots\|slot_source}}
	::: Slots to test.		::: Slots to test.
	~~::: {{arg desc\|je=item_slots}}{{until\|JE 26.3}}~~
	::: {{arg desc\|je=slot_source}}		::: {{arg desc\|je=slot_source}}
	:: {{Argument\|item_predicate\|item_predicate}}		:: {{Argument\|item_predicate\|item_predicate}}

SyncBot: Sync: updated from Minecraft

2026-09-16T11:14:31Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 16 September 2026
Line 653:		Line 653:
	::: {{arg desc\|je=entity}}		::: {{arg desc\|je=entity}}
	:: {{Argument\|slots\|item_slots}}{{until\|JE 26.3}}		:: {{Argument\|slots\|item_slots}}{{until\|JE 26.3}}
	:: {{Argument\|slots\|slot_source~~}}{{upcoming\|JE 26.3~~}}		:: {{Argument\|slots\|slot_source}}
	::: Slots to test.		::: Slots to test.
	::: {{arg desc\|je=item_slots}}{{until\|JE 26.3}}		::: {{arg desc\|je=item_slots}}{{until\|JE 26.3}}
	::: {{arg desc\|je=slot_source~~}}{{upcoming\|JE 26.3~~}}		::: {{arg desc\|je=slot_source}}
	:: {{Argument\|item_predicate\|item_predicate}}		:: {{Argument\|item_predicate\|item_predicate}}
	::: Item or item [[Minecraft:tag]] to test for.		::: Item or item [[Minecraft:tag]] to test for.
Line 962:		Line 962:
	\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added new syntax {{cmd\|execute (if{{!}}unless) stopwatch <id> <range>\|link=none}}.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added new syntax {{cmd\|execute (if{{!}}unless) stopwatch <id> <range>\|link=none}}.}}
	\|{{HistoryLine\|\|26.2\|dev=pre1\|{{cmd\|execute on owner\|link=none}} will now consider [[Minecraft:vex]]es as owned by their [[Minecraft:evoker]].}}		\|{{HistoryLine\|\|26.2\|dev=pre1\|{{cmd\|execute on owner\|link=none}} will now consider [[Minecraft:vex]]es as owned by their [[Minecraft:evoker]].}}
	~~\|{{HistoryLine\|upcoming java}}~~
	\|{{HistoryLine\|\|26.3\|dev=snap1\|Added new {{cd\|slots}} condition sub-command.\|The items condition sub-command now takes a [[Minecraft:Argument_types#minecraft:slot_source\|slot source]] as argument instead of a [[Minecraft:Argument_types#minecraft:item_slots\|item slots]].}}		\|{{HistoryLine\|\|26.3\|dev=snap1\|Added new {{cd\|slots}} condition sub-command.\|The items condition sub-command now takes a [[Minecraft:Argument_types#minecraft:slot_source\|slot source]] as argument instead of a [[Minecraft:Argument_types#minecraft:item_slots\|item slots]].}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-09-04T11:03:56Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 4 September 2026
Line 125:		Line 125:
	:*** <code>... (<\|<=\|=\|>\|>=) <source> <sourceObjective> -> [execute]</code>		:*** <code>... (<\|<=\|=\|>\|>=) <source> <sourceObjective> -> [execute]</code>
	:*** <code>... matches <range> -> [execute]</code>		:*** <code>... matches <range> -> [execute]</code>
			:** <code>... stopwatch <id> <range> -> [execute]</code>
	:* <code>... [[#run\|'''run''']] <''command''></code>		:* <code>... [[#run\|'''run''']] <''command''></code>
	: where <code>-> execute</code> represents the start of another subcommand that is required; <code>-> [execute]</code> represents the start of another subcommand that is optional.		: where <code>-> execute</code> represents the start of another subcommand that is required; <code>-> [execute]</code> represents the start of another subcommand that is optional.
Line 418:		Line 419:
	: When at the end of the subcommands chain, it checks whether the condition is met and then outputs. {{IN\|java}}, it has output values that can be stored by store subcommands.		: When at the end of the subcommands chain, it checks whether the condition is met and then outputs. {{IN\|java}}, it has output values that can be stored by store subcommands.

	There are ~~eleven~~{{only\|java\|short=1}} / four{{only\|bedrock\|short=1}} different types of conditions:		There are twelve{{only\|java\|short=1}} / four{{only\|bedrock\|short=1}} different types of conditions:
	# [[#ifunlessbiome\|(if\|unless) biome]] – Tests the biome in a position{{only\|java}}		# [[#ifunlessbiome\|(if\|unless) biome]] – Tests the biome in a position{{only\|java}}
	# [[#ifunlessblock\|(if\|unless) block]] – Tests a single block		# [[#ifunlessblock\|(if\|unless) block]] – Tests a single block
Line 430:		Line 431:
	# [[#ifunlesspredicate\|(if\|unless) predicate]] – Tests a [[Minecraft:predicate]]{{only\|java}}		# [[#ifunlesspredicate\|(if\|unless) predicate]] – Tests a [[Minecraft:predicate]]{{only\|java}}
	# [[#ifunlessscore\|(if\|unless) score]] - Tests a target's score		# [[#ifunlessscore\|(if\|unless) score]] - Tests a target's score
			# [[#ifunlessscore\|(if\|unless) stopwatch]] - Tests a stopwatch's elapsed time (in seconds) against a given value range.{{only\|java}}

	{{anchor\|ifunlessbiome}}		{{anchor\|ifunlessbiome}}
Line 755:		Line 757:
	:: {{IN\|java}}, when at the end of the subcommand chain, if the command is successful, both <code>success</code> value and <code>result</code> value are 1.		:: {{IN\|java}}, when at the end of the subcommand chain, if the command is successful, both <code>success</code> value and <code>result</code> value are 1.

	==== ~~Example~~ ====		{{anchor\|ifunlessstopwatch}}
	: ~~Kill all players standing on~~ a ~~wool~~:
	:* <code>~~execute as @a at @s~~ '''~~if block ~ ~-1 ~ #wool~~''' ~~run kill @s~~</code>{{~~only~~\|~~java~~}}		==== (if\|unless) stopwatch ====
	:* <code>~~execute as @a at @s '''if block ~ ~-1 ~ wool''' run kill @s~~</code>~~{{only\|bedrock}}~~		{{exclusive\|section=1\|java}}
	~~: Check whether scores A~~ and ~~B are equal:~~ <code>~~execute '''if score @s A = @s B'''~~</code>		Compares the elapsed time of a given [[Minecraft:stopwatch]] to a floating point value range.

			:;Syntax
			:: <code>(if\|unless) '''stopwatch''' <id> <range> -> [execute]</code>
			:;Arguments
			::{{Argument\|id\|resource_location}}
			:: Specifies the stopwatch to target.

			:: {{Argument\|range\|float_range}}
			:: The range in seconds to compare against.

			:: {{arg desc\|je=float_range}}

			:;Result
			:: Unparseable if the argument is not specified correctly.
			:: In following conditions, terminates current branch when this subcommand is not at the end of the subcommand chain; fails when at the end:
			::* If test doesn't pass.
			:: When at the end of the subcommand chain, if the command is successful, both <code>success</code> value and <code>result</code> value are 1.

	{{anchor\|store}}		{{anchor\|store}}
Line 902:		Line 921:
	:: Execute this command. Fails if <code><''command''></code> or <code>command: command</code> is failure.		:: Execute this command. Fails if <code><''command''></code> or <code>command: command</code> is failure.

	=== ~~More examples~~ ===		=== Examples ===
	* Teleport all players who have an item enchanted with [[Minecraft:Efficiency]] in their first hotbar slot to coordinates (0, 64, 0):		* Teleport all players who have an item enchanted with [[Minecraft:Efficiency]] in their first hotbar slot to coordinates (0, 64, 0):
	*: <code>/execute as @a if data entity @s Inventory[{Slot:0b}].tag.Enchantments[{id:"minecraft:efficiency"}] run tp @s 0 64 0</code>{{only\|java}}		*: <code>/execute as @a if data entity @s Inventory[{Slot:0b}].tag.Enchantments[{id:"minecraft:efficiency"}] run tp @s 0 64 0</code>{{only\|java}}

SyncBot: Sync: updated from Minecraft

2026-08-09T11:17:24Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:17, 9 August 2026
Line 8:		Line 8:
	}}		}}
	{{TOC\|right}}		{{TOC\|right}}
			{{Update\|{{cd\|slots}} condition sub-command ([[Minecraft:26.3-snap1]]) }}
	Executes another [[Minecraft:command]] but allows changing the executor, changing the position and angle it is executed at, adding preconditions, and storing its result.		Executes another [[Minecraft:command]] but allows changing the executor, changing the position and angle it is executed at, adding preconditions, and storing its result.

Line 649:		Line 650:
	::: Entity to test.		::: Entity to test.
	::: {{arg desc\|je=entity}}		::: {{arg desc\|je=entity}}
	:: {{Argument\|slots\|item_slots}}		:: {{Argument\|slots\|item_slots}}{{until\|JE 26.3}}
	::: Slots to test. ~~A string that consists of a "slot type" and an optional "slot number", in the format of <code><slot_type></code>, <code><slot_type>~~.~~<slot_number></code> or <code><slot_type>.*</code>. See [[Minecraft~~:~~Slot]] for details~~.		:: {{Argument\|slots\|slot_source}}{{upcoming\|JE 26.3}}
			::: Slots to test.
			::: {{arg desc\|je=item_slots}}{{until\|JE 26.3}}
			::: {{arg desc\|je=slot_source}}{{upcoming\|JE 26.3}}
	:: {{Argument\|item_predicate\|item_predicate}}		:: {{Argument\|item_predicate\|item_predicate}}
	::: Item or item [[Minecraft:tag]] to test for.		::: Item or item [[Minecraft:tag]] to test for.
Line 940:		Line 944:
	\|{{HistoryLine\|\|26.2\|dev=pre1\|{{cmd\|execute on owner\|link=none}} will now consider [[Minecraft:vex]]es as owned by their [[Minecraft:evoker]].}}		\|{{HistoryLine\|\|26.2\|dev=pre1\|{{cmd\|execute on owner\|link=none}} will now consider [[Minecraft:vex]]es as owned by their [[Minecraft:evoker]].}}
	\|{{HistoryLine\|upcoming java}}		\|{{HistoryLine\|upcoming java}}
	\|{{HistoryLine\|\|26.3\|dev=~~snapshot1~~\|Added new {{cd\|slots}} condition sub-command.\|The items condition sub-command now takes a slot source as argument instead of a ~~slot~~.}}		\|{{HistoryLine\|\|26.3\|dev=snap1\|Added new {{cd\|slots}} condition sub-command.\|The items condition sub-command now takes a [[Minecraft:Argument_types#minecraft:slot_source\|slot source]] as argument instead of a [[Minecraft:Argument_types#minecraft:item_slots\|item slots]].}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-07-08T11:05:27Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:05, 8 July 2026
Line 271:		Line 271:
	==== in ====		==== in ====
	: Sets the ''execution dimension'' and ''execution position''.		: Sets the ''execution dimension'' and ''execution position''.
	: It respects dimension scaling for relative and local coordinates: the ''execution position'' (only the X/Z part) is divided by 8 when changing from the Overworld to the Nether, and is multiplied by 8 when vice versa. Applies to [[Minecraft:custom dimension]]s as well.		: It respects dimension scaling for relative and local coordinates; the ''execution position'' (only the X/Z part) is divided by 8 when changing from the Overworld to the Nether, and is multiplied by 8 when vice versa. Applies to [[Minecraft:custom dimension]]s as well.
	:;Syntax		:;Syntax
	: {{el\|java}}:		: {{el\|java}}:

SyncBot: Sync: updated from Minecraft

2026-06-25T11:09:54Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 25 June 2026
Line 939:		Line 939:
	\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added new syntax {{cmd\|execute (if{{!}}unless) stopwatch <id> <range>\|link=none}}.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added new syntax {{cmd\|execute (if{{!}}unless) stopwatch <id> <range>\|link=none}}.}}
	\|{{HistoryLine\|\|26.2\|dev=pre1\|{{cmd\|execute on owner\|link=none}} will now consider [[Minecraft:vex]]es as owned by their [[Minecraft:evoker]].}}		\|{{HistoryLine\|\|26.2\|dev=pre1\|{{cmd\|execute on owner\|link=none}} will now consider [[Minecraft:vex]]es as owned by their [[Minecraft:evoker]].}}
			\|{{HistoryLine\|upcoming java}}
			\|{{HistoryLine\|\|26.3\|dev=snapshot1\|Added new {{cd\|slots}} condition sub-command.\|The items condition sub-command now takes a slot source as argument instead of a slot.}}
	}}		}}

← Older revision		Revision as of 11:09, 18 October 2026
Line 431:		Line 431:
	# [[#ifunlesspredicate\|(if\|unless) predicate]] – Tests a [[Minecraft:predicate]]{{only\|java}}		# [[#ifunlesspredicate\|(if\|unless) predicate]] – Tests a [[Minecraft:predicate]]{{only\|java}}
	# [[#ifunlessscore\|(if\|unless) score]] - Tests a target's score		# [[#ifunlessscore\|(if\|unless) score]] - Tests a target's score
	# [[#~~ifunlessscore~~\|(if\|unless) stopwatch]] - Tests a stopwatch's elapsed time (in seconds) against a given value range.{{only\|java}}		# [[#ifunlessstopwatch\|(if\|unless) stopwatch]] - Tests a stopwatch's elapsed time (in seconds) against a given value range.{{only\|java}}

	{{anchor\|ifunlessbiome}}		{{anchor\|ifunlessbiome}}

← Older revision		Revision as of 11:12, 17 September 2026
Line 652:		Line 652:
	::: Entity to test.		::: Entity to test.
	::: {{arg desc\|je=entity}}		::: {{arg desc\|je=entity}}
	~~:: {{Argument\|slots\|item_slots}}{{until\|JE 26.3}}~~
	:: {{Argument\|slots\|slot_source}}		:: {{Argument\|slots\|slot_source}}
	::: Slots to test.		::: Slots to test.
	~~::: {{arg desc\|je=item_slots}}{{until\|JE 26.3}}~~
	::: {{arg desc\|je=slot_source}}		::: {{arg desc\|je=slot_source}}
	:: {{Argument\|item_predicate\|item_predicate}}		:: {{Argument\|item_predicate\|item_predicate}}

← Older revision		Revision as of 11:14, 16 September 2026
Line 653:		Line 653:
	::: {{arg desc\|je=entity}}		::: {{arg desc\|je=entity}}
	:: {{Argument\|slots\|item_slots}}{{until\|JE 26.3}}		:: {{Argument\|slots\|item_slots}}{{until\|JE 26.3}}
	:: {{Argument\|slots\|slot_source~~}}{{upcoming\|JE 26.3~~}}		:: {{Argument\|slots\|slot_source}}
	::: Slots to test.		::: Slots to test.
	::: {{arg desc\|je=item_slots}}{{until\|JE 26.3}}		::: {{arg desc\|je=item_slots}}{{until\|JE 26.3}}
	::: {{arg desc\|je=slot_source~~}}{{upcoming\|JE 26.3~~}}		::: {{arg desc\|je=slot_source}}
	:: {{Argument\|item_predicate\|item_predicate}}		:: {{Argument\|item_predicate\|item_predicate}}
	::: Item or item [[Minecraft:tag]] to test for.		::: Item or item [[Minecraft:tag]] to test for.
Line 962:		Line 962:
	\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added new syntax {{cmd\|execute (if{{!}}unless) stopwatch <id> <range>\|link=none}}.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added new syntax {{cmd\|execute (if{{!}}unless) stopwatch <id> <range>\|link=none}}.}}
	\|{{HistoryLine\|\|26.2\|dev=pre1\|{{cmd\|execute on owner\|link=none}} will now consider [[Minecraft:vex]]es as owned by their [[Minecraft:evoker]].}}		\|{{HistoryLine\|\|26.2\|dev=pre1\|{{cmd\|execute on owner\|link=none}} will now consider [[Minecraft:vex]]es as owned by their [[Minecraft:evoker]].}}
	~~\|{{HistoryLine\|upcoming java}}~~
	\|{{HistoryLine\|\|26.3\|dev=snap1\|Added new {{cd\|slots}} condition sub-command.\|The items condition sub-command now takes a [[Minecraft:Argument_types#minecraft:slot_source\|slot source]] as argument instead of a [[Minecraft:Argument_types#minecraft:item_slots\|item slots]].}}		\|{{HistoryLine\|\|26.3\|dev=snap1\|Added new {{cd\|slots}} condition sub-command.\|The items condition sub-command now takes a [[Minecraft:Argument_types#minecraft:slot_source\|slot source]] as argument instead of a [[Minecraft:Argument_types#minecraft:item_slots\|item slots]].}}
	}}		}}