Commands/testforblock

From Minecraft Wiki
Jump to: navigation, search
Mclogo.svg
testforblock
Restrictions

Operator

First introduced

1.7.2 (13w37a)
PE Alpha 0.16.0 (PE Alpha 0.16.0 build 1)

Removed

17w45a

Tests whether a certain block is in a specific location.

Syntax
testforblock <position: x y z> <tileName: Block> [dataValue: int]
Arguments
position: x y z
Specifies the position of the block to test. x and z must be between -30,000,000 and 30,000,000 (inclusive, without the commas) and y must be between 0 and 255 (inclusive). May use tilde notation to specify a position relative to the command's execution.
tileName: block"
Specifies the block to test for. Must be a valid block id (for example, minecraft:stone).
dataValue: int (optional)
Specifies the block data to test for. dataValue must be between -1 and 15 (inclusive). If not specified, or if -1, dataValue matches any block data value.
Result
Fails if the arguments are not specified correctly, if the block at the specified position does not match the specified block id or data, or if the specified data tag has different values than what is defined in the block's data tag (dataTag does not need to match the block's entire data tag, and data tags in the argument which are undefined in the block will not cause the command to fail).
On success, returns a success count of 1.
Examples
To test if the block at (0,64,0) is any type of wool:
testforblock 0 64 0 wool
testforblock 0 64 0 wool -1
To test if the block at (0,64,0) is orange wool:
testforblock 0 64 0 wool 1
To test if the block below is a jukebox:
testforblock ~ ~-1 ~ jukebox -1


Promotional Content