此特性为基岩版独有。
测试两个区域中的方块是否相同。
语法
testforblocks <源区域起始:x y z> <源区域终止:x y z> <目标区域基点:x y z> [模式:字符串]
- 以上的背景色是为了方便阅读。
参数
- <源区域起始:x y z>与<源区域终止:x y z>
- 指定作为样式基准的区域(源区域)的两个对角方块。x1、z1、x2及z2必须在-30,000,000和30,000,000之间(含,不输入逗号),且y1及y2必须在0和255之间(含)。可以使用波浪号来指定基于命令执行位置的相对坐标。源区域中的方块数量不能超过524,288个。
- 目标区域基点:x y z
- 指定待检查区域(目标区域)的下西北角(具有最小坐标值的边角)。x和z必须在-30,000,000和30,000,000之间(含,不输入逗号),且y必须在0和255之间(含)。可以使用波浪号来指定基于命令执行位置的相对坐标。源区域和目标区域可以重叠。
- masked|all(可选)
- 指定测试模式。必须为下列其中之一:
all
— 两个区域的所有方块必须完全相同。masked
— 源区域的空气方块可匹配目标区域的任意方块。
- 若未指定,默认为
all
。
- 指定测试模式。必须为下列其中之一:
效果
- 如果参数未正确指定,或源区域和目标区域不匹配,则失败。
- 成功时,返回匹配方块的总数量(
all
模式下所有方块的数量,或masked
模式下的源区域非空气方块的数量)。
命令
Java版 | |||||
---|---|---|---|---|---|
1.7.2 | 13w37a | 加入了/testforblock 。 | |||
1.11 | 16w32a | 为/testforblock 加入了方块状态支持。 | |||
1.13 | 17w45a | 移除了/testforblock 。 | |||
携带版Alpha | |||||
0.16.0 | build 1 | 加入了/testforblock 。 |