Minecraft:Commands/testfor - Revision history

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T20:14:30Z

Fix template calls: add MC/ prefix

← Older revision		Revision as of 20:14, 9 April 2026
Line 1:		Line 1:
	{{~~exclusive~~\|bedrock}}		{{MC/Exclusive\|bedrock}}
	{{outdated\|edition=java}}		{{outdated\|edition=java}}
	{{Infobox command		{{Infobox command
Line 17:		Line 17:
	==Arguments==		==Arguments==

	{{~~argument~~\|be=1\|victim: target\|CommandSelector<Actor>}}		{{MC/Argument\|be=1\|victim: target\|CommandSelector<Actor>}}
	: Specifies the entities to test.		: Specifies the entities to test.
	: {{~~arg~~ desc\|be=actor}}		: {{MC/Arg desc\|be=actor}}

	==Result==		==Result==
Line 31:		Line 31:
	== Output ==		== Output ==

	{{Output table\|onlybe=1}}		{{MC/Output table\|onlybe=1}}
	{{Output table\|On fail\|0}}		{{MC/Output table\|On fail\|0}}
	{{Output table\|On success\|the number of the specified entities.}}		{{MC/Output table\|On success\|the number of the specified entities.}}
	{{Output table}}		{{MC/Output table}}

	==Examples==		==Examples==
Line 48:		Line 48:
	=== ''Java Edition'' ===		=== ''Java Edition'' ===
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java}}		\|{{MC/HistoryLine\|java}}
	\|{{HistoryLine\|\|1.5\|dev=13w03a\|Added {{~~cmd~~\|testfor\|link=none}}.}}		\|{{HistoryLine\|\|1.5\|dev=13w03a\|Added {{MC/Cmd\|testfor\|link=none}}.}}
	\|{{HistoryLine\|\|1.8\|dev=14w02a\|Added {{cd\|dataTag}} argument to {{~~cmd~~\|testfor\|link=none}}.		\|{{HistoryLine\|\|1.8\|dev=14w02a\|Added {{MC/Cd\|dataTag}} argument to {{MC/Cmd\|testfor\|link=none}}.
	\|{{~~cmd~~\|testfor\|link=none}} is no longer exclusive to command blocks.}}		\|{{MC/Cmd\|testfor\|link=none}} is no longer exclusive to command blocks.}}
	\|{{HistoryLine\|\|\|dev=14w07a\|{{~~cmd~~\|testfor\|link=none}} can now test for partial NBT tag matches.}}		\|{{HistoryLine\|\|\|dev=14w07a\|{{MC/Cmd\|testfor\|link=none}} can now test for partial NBT tag matches.}}
	\|{{HistoryLine\|\|1.13\|dev=17w45a\|Removed {{~~cmd~~\|testfor\|link=none}}.}}		\|{{HistoryLine\|\|1.13\|dev=17w45a\|Removed {{MC/Cmd\|testfor\|link=none}}.}}
	}}		}}

	=== ''Bedrock Edition'' ===		=== ''Bedrock Edition'' ===
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|pocket}}		\|{{MC/HistoryLine\|pocket}}
	\|{{HistoryLine\|\|1.0.5\|dev=alpha 1.0.5.0\|Added {{~~cmd~~\|testfor\|link=none}}.}}		\|{{HistoryLine\|\|1.0.5\|dev=alpha 1.0.5.0\|Added {{MC/Cmd\|testfor\|link=none}}.}}
	}}		}}

Line 67:		Line 67:

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

	de:Befehl/testfor		de:Befehl/testfor

SyncBot: Remove broken links to missing pages

2026-04-09T15:45:38Z

Remove broken links to missing pages

← Older revision		Revision as of 15:45, 9 April 2026
Line 9:		Line 9:
	}}		}}

	Counts ~~[[Minecraft:~~entities]] (~~[[Minecraft:~~players]], ~~[[Minecraft:~~mobs]], ~~[[Minecraft:~~items]], etc.) matching specified conditions.		Counts entities (players, mobs, items, etc.) matching specified conditions.

	==Syntax==		==Syntax==
Line 69:		Line 69:
	{{Navbox commands}}		{{Navbox commands}}

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

imported>LauraFii: /* History */ split

2025-11-04T07:48:45Z

History: split

New page

{{exclusive|bedrock}}
{{outdated|edition=java}}
{{Infobox command
|name=testfor
|oplevel=
* 2 {{only|java|short=1}}
* 1 {{only|bedrock|short=1}}
|cheat=y
}}

Counts [[Minecraft:entities]] ([[Minecraft:players]], [[Minecraft:mobs]], [[Minecraft:items]], etc.) matching specified conditions.

==Syntax==

: <code>testfor <victim: target></code>

==Arguments==

{{argument|be=1|victim: target|CommandSelector<Actor>}}
: Specifies the entities to test.
: {{arg desc|be=actor}}

==Result==

{{Result table|onlybe=1}}
{{Result table|The command is incomplete, or any argument is not specified correctly.||unparseable}}
{{Result table|<code>victim: target</code> fails to resolve to one or more entities (named players must be online).||fail}}
{{Result table|succeed}}
{{Result table}}

== Output ==

{{Output table|onlybe=1}}
{{Output table|On fail|0}}
{{Output table|On success|the number of the specified entities.}}
{{Output table}}

==Examples==

* To test if Alice is online: <code>testfor Alice</code>
* To count the number of players in Survival mode within a 3-block radius of (0,64,0): <code>testfor @a[x=0,y=64,z=0,r=3,m=0]</code>
* To count the number of zombies within a 20-block radius of (0,64,0): <code>testfor @e[x=0,y=64,z=0,r=20,type=zombie]</code>
* To check if a random player has iron ingots in their inventory <code>testfor @r[hasitem={item=iron_ingot}]</code>
* To check if a random player does not have iron ingots in their inventory <code>testfor @r[hasitem={item=iron_ingot},quantity=0]</code>
* To check if a random is holding iron ingots in their inventory <code>testfor @r[hasitem={item=iron_ingot},location=slots.weapon.mainhand]</code>

== History ==
=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.5|dev=13w03a|Added {{cmd|testfor|link=none}}.}}
|{{HistoryLine||1.8|dev=14w02a|Added {{cd|dataTag}} argument to {{cmd|testfor|link=none}}.
|{{cmd|testfor|link=none}} is no longer exclusive to command blocks.}}
|{{HistoryLine|||dev=14w07a|{{cmd|testfor|link=none}} can now test for partial NBT tag matches.}}
|{{HistoryLine||1.13|dev=17w45a|Removed {{cmd|testfor|link=none}}.}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|pocket}}
|{{HistoryLine||1.0.5|dev=alpha 1.0.5.0|Added {{cmd|testfor|link=none}}.}}
}}

== External links ==

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

== Navigation ==
{{Navbox commands}}

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