此特性为基岩版独有。
命令/infobox
探测某个方块是否在特定位置。
- 语法
testforblock <位置:x y z> <方块名:字符串> [数据值:整数]
- 参数
- 位置:x y z
- 指定待探测的方块的坐标。x 和 z必须是在-30,000,000和30,000,000之间(含,不输入逗号)的整数,且y必须在0和255之间(含)。可以使用波浪号来指定基于命令执行位置的相对坐标。
- 方块名:字符串
- 指定要探测的方块类型。必须是有效的方块ID(例如
minecraft:stone
)。
- 指定要探测的方块类型。必须是有效的方块ID(例如
- 数据值:整数(可选)
- 指定要探测的方块数据。数据值必须在-1和15之间(含)。如果未指定或为
-1
,则数据值匹配任意的数据值。
- 指定要探测的方块数据。数据值必须在-1和15之间(含)。如果未指定或为
- 效果
- 如果没有正确指定参数,或指定位置的方块不匹配指定的方块ID、方块数据或数据标签(数据标签的内容不需要与被测方块的数据标签完全一致;命令参数中未定义数据标签项目也不会造成失败)时,命令失败。
- 成功时,返回命令成功计数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 。 | |||
携带版Alpha | |||||
0.16.0 | build 1 | 加入了/testforblock 。 |