Commands/testfor

testfor

Restrictions	Operator
First introduced	Java Edition 1.5 (Java Edition 13w03a) PE 1.0.5 (Pocket Edition alpha 1.0.5.0)
Removed	Java Edition 17w45a

Counts entities (players, mobs, items, etc.) matching specified conditions.

Syntax

testfor <victim: target>

Arguments

victim: target

Specifies the targets to count. Must be a player name or a target selector (@e is permitted to target entities other than players).

Result

Fails if the arguments are not specified correctly, or if player 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 player, which can be measured by a redstone comparator facing away from the command block.

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]

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.