/testfor

From Minecraft Wiki
Jump to navigation Jump to search
This feature is exclusive to Bedrock Edition.
 
BlockSprite rose.png: Sprite image for rose in Minecraft
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
  • 2 ‌[JE only]
  • 1 ‌[BE only]
Restrictions Cheat only

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

Syntax

[edit | edit source]
testfor <victim: target>

Arguments

[edit | edit source]

victim: target: CommandSelector<Actor>

Specifies the entities to test.
Must be a player name or a target selector.

Result

[edit | edit source]

CommandTriggerBedrock Edition
AnyThe 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
OtherwiseSuccessful

Output

[edit | edit source]

CommandEditionSituationSuccess Count
AnyBedrock EditionOn fail0
On successthe number of the specified entities.

Examples

[edit | edit source]
  • 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

[edit | edit source]

Java Edition

[edit | edit source]
Java Edition
1.513w03aAdded /testfor.
1.814w02aAdded dataTag argument to /testfor.
/testfor is no longer exclusive to command blocks.
14w07a/testfor can now test for partial NBT tag matches.
1.1317w45aRemoved /testfor.

Bedrock Edition

[edit | edit source]
Pocket Edition
1.0.5alpha 1.0.5.0Added /testfor.
[edit | edit source]
[edit | edit source]