/testfor
< Commands
This feature is exclusive to Bedrock Edition.
This page describes content that has been removed from the game.
This feature was present in earlier versions of Java Edition, but has since been removed.
/testfor| Permission level required |
|
|---|---|
| Restrictions |
Cheat only |
{
"title": "<code>/testfor</code>",
"rows": [
{
"field": "\n* 2 <sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Java Edition\">(link to Java Edition article, displayed as JE) only</span></i>]</sup>\n* 1 <sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE) only</span></i>]</sup>",
"label": "(link to Permission level article, displayed as Permission level<br>required)"
},
{
"field": "(link to Option article, displayed as Cheat) only<br>",
"label": "(link to Commands#Restrictions article, displayed as Restrictions)"
}
],
"invimages": [],
"images": []
}
Counts entities (players, mobs, items, etc.) matching specified conditions.
Syntax
testfor <victim: target>
Arguments
victim: target: CommandSelector<Actor>
- Specifies the entities to test.
- Must be a player name or a target selector.
Result
| Command | Trigger | Bedrock Edition |
|---|---|---|
| Any | The command is incomplete, or any argument is not specified correctly. | Unparseable |
victim: target fails to resolve to one or more entities (named players must be online). | Failed | |
| Otherwise | Successful |
Output
| Command | Edition | Situation | Success Count |
|---|---|---|---|
| Any | Bedrock Edition | On fail | 0 |
| On success | the number of the specified entities. |
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 | |||||||
|---|---|---|---|---|---|---|---|
| 1.5 | 13w03a | Added /testfor. | |||||
| 1.8 | 14w02a | Added dataTag argument to /testfor.
| |||||
/testfor is no longer exclusive to command blocks. | |||||||
| 14w07a | /testfor can now test for partial NBT tag matches. | ||||||
| 1.13 | 17w45a | Removed /testfor. | |||||
| Pocket Edition | |||||||
| 1.0.5 | alpha 1.0.5.0 | Added /testfor. | |||||