Commands/testfor
< Commands
This feature is exclusive to Bedrock Edition.
testfor
| Restrictions | |
|---|---|
| First introduced |
Java Edition 1.5 (13w03a) |
| Removed |
Counts entities (players, mobs, items, etc.) matching specified conditions.
Contents
Syntax[edit]
testfor <victim: target>
Arguments[edit]
victim: target
- Specifies the targets to count. Must be a player name or a target selector.
- Permits entities other than players.
Result[edit]
Fails if the arguments are not specified correctly, or if victim: target fails to resolve to one or more entities (named players must be online).
On success, produces a success count equal to the number of targets matching victim: target, which can be measured by a redstone comparator facing away from the command block.
Examples[edit]
- 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]
History[edit]
| 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. | |||
