命令/testforblock

testforblock

需要的权限等级	1
限制条件	启用作弊

探测某个方块是否在特定位置。

语法

testforblock <position: x y z> <tileName: Block> [blockStates: block states]

testforblock <position: x y z> <tileName: Block> [dataValue: int]

参数

position: x y z

指定待探测的方块的坐标。x 和 z必须是在-30,000,000和30,000,000之间（含，不输入逗号）的整数，且y必须在0和255之间（含）。可以使用波浪号来指定基于命令执行位置的相对坐标。

tileName: Block

指定要探测的方块类型。必须是有效的方块ID（例如minecraft:stone）。

dataValue: int（可选）

指定要探测的方块数据。数据值必须在-1和15之间（含)。如果未指定或为-1，则数据值匹配任意的数据值。

blockStates: block states（可选）

指定要探测的方块状态。

效果

如果没有正确指定参数，或指定位置的方块不匹配指定的方块ID、方块数据或NBT标签（NBT标签的内容不需要与被测方块的NBT标签完全一致；命令参数中未定义NBT标签项目也不会造成失败）时，命令失败。

成功时，返回命令成功计数1。

示例

检测坐标(0,64,0)处是否为任意颜色的羊毛：

testforblock 0 64 0 wool

testforblock 0 64 0 wool -1

检测坐标(0,64,0)处是否为橙色羊毛：

testforblock 0 64 0 wool 1

检测下方方块是否为唱片机：

testforblock ~ ~-1 ~ jukebox -1

历史

Java版
1.7.2		13w37a			加入了/testforblock。
1.11		16w32a			为/testforblock加入了方块状态的支持。
1.13		17w45a			移除了/testforblock以支持/execute if。
携带版Alpha
0.16.0		build 1			加入了/testforblock。

命令

参见：Template:Commands/content [编辑]