与方块有关的 Molang 查询函数
适用版本:国际版 26.60,中国版 3.10(1.21.130)。
下文的所有 Molang 均链接到官方文档,读者可点击查阅。
方块标签
| Molang | 描述 | 返回值 | 示例 |
|---|---|---|---|
query.all_tags(...tags: string) | 返回该物品或方块是否拥有所有特定标签。 | 否:0.0,是:1.0 | query.all_tags('example:tag') |
query.any_tag(...tags: string) | 返回该物品或方块是否拥有任一特定标签。 | 否:0.0,是:1.0 | query.any_tag('example:tag') |
query.block_has_all_tags(x: float, y: float, z: float, ...tags: string) | 返回特定位置的方块是否拥有所有特定标签。 | 否:0.0,是:1.0 | query.block_has_all_tags(30, 30, 30, 'example:tag') |
query.block_has_any_tag(x: float, y: float, z: float, ...tags: string) | 返回特定位置的方块是否拥有任一特定标签。 | 否:0.0,是:1.0 | query.block_has_any_tag(30, 30, 30, 'example:tag') |
query.relative_block_has_all_tags(x: float, y: float, z: float, ...tags: string) | 返回实体相对坐标位置的方块是否拥有所有特定标签。 | 否:0.0,是:1.0 | query.relative_block_has_all_tags(0, -1, 0, 'example:tag') |
query.relative_block_has_any_tag(x: float, y: float, z: float, ...tags: string) | 返回实体相对坐标位置的方块是否拥有任一特定标签。 | 否:0.0,是:1.0 | query.relative_block_has_any_tag(0, -1, 0, 'example:tag') |
query.block_neighbor_has_all_tags(x: float, y: float, z: float, ...tags: string) | 返回此方块临近位置的方块是否拥有所有特定标签。 | 否:0.0,是:1.0 | query.block_neighbor_has_all_tags(0, -1, 0, 'example:tag') |
query.block_neighbor_has_any_tag(x: float, y: float, z: float, ...tags: string) | 返回此方块临近位置的方块是否拥有任一特定标签。 | 否:0.0,是:1.0 | query.block_neighbor_has_any_tag(0, -1, 0, 'example:tag') |
方块状态
| Molang | 描述 | 返回值 | 示例 |
|---|---|---|---|
query.block_state(block_state: string) | 返回该方块的方块状态值。 | 方块状态值 | query.block_state('example:color') == 'blue' |
query.has_block_state(block_state: string) | 返回该方块是否拥有给定的方块状态。 | 否:0.0,是:1.0 | query.has_block_state('example:color') |
注意:
query.block_property()和query.has_block_property()是上面两个查询的旧称,自格式版本1.20.40起已被移除,请勿再使用。
其他
| Molang | 描述 | 返回值 | 示例 |
|---|---|---|---|
query.block_face | 返回该方块的面(仅限放置方块或与方块交互时可用)。 | 底:0.0、顶:1.0、北:2.0、南:3.0、西:4.0、东:5.0、未定义:6.0 | query.block_face == 1.0 |
query.is_connect(face: int) | (仅中国版可用)返回该方块特定面所接触的方块是否拥有connection属性。face允许的参数为:底:0、顶:1、北:2、南:3、西:4、东:5。 | 否:0.0,是:1.0 | query.is_connect(0) |