Minecraft:Commands/testfor: Difference between revisions
From SAS Gaming Wiki
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{exclusive|bedrock}} | ||
{{outdated|edition=java}} | {{outdated|edition=java|This command was merged with the {{cmd|execute}} command in [[Minecraft:Java Edition 17w45a]].}} | ||
{{Infobox command | {{Infobox command | ||
|name=testfor | |name=testfor | ||
| Line 9: | Line 9: | ||
}} | }} | ||
Counts entities (players, mobs, items, etc.) matching specified conditions. | Counts [[Minecraft:entities]] ([[Minecraft:players]], [[Minecraft:mobs]], [[Minecraft:items]], etc.) matching specified conditions. | ||
==Syntax== | ==Syntax== | ||
| Line 17: | Line 17: | ||
==Arguments== | ==Arguments== | ||
{{ | {{argument|be=1|victim: target|CommandSelector<Actor>}} | ||
: Specifies the entities to test. | : Specifies the entities to test. | ||
: {{ | : {{arg desc|be=actor}} | ||
==Result== | ==Result== | ||
| Line 31: | Line 31: | ||
== Output == | == Output == | ||
{{ | {{Output table|onlybe=1}} | ||
{{ | {{Output table|On fail|0}} | ||
{{ | {{Output table|On success|the number of the specified entities.}} | ||
{{ | {{Output table}} | ||
==Examples== | ==Examples== | ||
| Line 48: | Line 48: | ||
=== ''Java Edition'' === | === ''Java Edition'' === | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|java}} | ||
|{{HistoryLine||1.5|dev=13w03a|Added {{ | |{{HistoryLine||1.5|dev=13w03a|Added {{cmd|testfor|link=none}}.}} | ||
|{{HistoryLine||1.8|dev=14w02a|Added {{ | |{{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|{{ | |{{HistoryLine|||dev=14w07a|{{cmd|testfor|link=none}} can now test for partial NBT tag matches.}} | ||
|{{HistoryLine||1.13|dev=17w45a|Removed {{ | |{{HistoryLine||1.13|dev=17w45a|Removed {{cmd|testfor|link=none}}.}} | ||
}} | }} | ||
=== ''Bedrock Edition'' === | === ''Bedrock Edition'' === | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|pocket}} | ||
|{{HistoryLine||1.0.5|dev=alpha 1.0.5.0|Added {{ | |{{HistoryLine||1.0.5|dev=alpha 1.0.5.0|Added {{cmd|testfor|link=none}}.}} | ||
}} | }} | ||
| Line 67: | Line 67: | ||
== Navigation == | == Navigation == | ||
{{ | {{Navbox commands}} | ||
de:Befehl/testfor | [[Minecraft:de:Befehl/testfor]] | ||
es:Comandos/testfor | [[Minecraft:es:Comandos/testfor]] | ||
ja:コマンド/testfor | [[Minecraft:ja:コマンド/testfor]] | ||
pt:Comandos/testfor | [[Minecraft:pt:Comandos/testfor]] | ||
ru:Команды консоли/testfor | [[Minecraft:ru:Команды консоли/testfor]] | ||
zh:命令/testfor | [[Minecraft:zh:命令/testfor]] | ||
Latest revision as of 11:05, 12 October 2026
Template:Exclusive Template:Outdated Template:Infobox command
Counts Minecraft:entities (Minecraft:players, Minecraft:mobs, Minecraft:items, etc.) matching specified conditions.
Syntax
testfor <victim: target>
Arguments
- Specifies the entities to test.
- Template:Arg desc
Result
Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table
Output
Template:Output table Template:Output table Template:Output table Template:Output table
Examples
- To test if Alice is online:
testfor Alice - To count the number of players in Survival mode within a 3-block radius of (0,64,0):
testfor @a[x=0,y=64,z=0,r=3,m=0] - To count the number of zombies within a 20-block radius of (0,64,0):
testfor @e[x=0,y=64,z=0,r=20,type=zombie] - To check if a random player has iron ingots in their inventory
testfor @r[hasitem={item=iron_ingot}] - To check if a random player does not have iron ingots in their inventory
testfor @r[hasitem={item=iron_ingot},quantity=0] - To check if a random is holding iron ingots in their inventory
testfor @r[hasitem={item=iron_ingot},location=slots.weapon.mainhand]
History
Java Edition
Bedrock Edition
External links
Minecraft:de:Befehl/testfor Minecraft:es:Comandos/testfor Minecraft:ja:コマンド/testfor Minecraft:pt:Comandos/testfor Minecraft:ru:Команды консоли/testfor Minecraft:zh:命令/testfor