命令/testforblocks

命令/infobox

测试两个区域中的方块是否相同。

语法

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模式下的源区域非空气方块的数量）。