> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/blocks-interactions.md).

# 方块与交互触发器

下列各节按当前事件上下文说明。PLAYER 为累计任务进度的玩家，TARGET 不自动等于 PLAYER，缺失数据保持缺失。这些触发器观察进度，不提供可修改的伤害/掉落结果。

## 配置示例

```yaml
source:
  trigger: block_break
  amount: 10
```

## `block_break`

玩家破坏方块时触发，默认防刷排除已记录玩家放置方块。

| 上下文                  | 值                     |
| -------------------- | --------------------- |
| 事件/载荷                | `BlockBreakEvent`     |
| 可用性                  | Paper 和 Spigot        |
| PLAYER               | 此事件关联的玩家              |
| SOURCE               | 任务玩家                  |
| TARGET               | 缺省                    |
| LOCATION             | 事件方块中心                |
| TRIGGER\_ITEM / slot | 主手 / HAND             |
| BLOCK                | 事件方块或移动终点方块           |
| 附加数据                 | `original_experience` |

## `block_damage`

玩家开始损坏方块时触发，不要求最终破坏。

| 上下文                  | 值                  |
| -------------------- | ------------------ |
| 事件/载荷                | `BlockDamageEvent` |
| 可用性                  | Paper 和 Spigot     |
| PLAYER               | 此事件关联的玩家           |
| SOURCE               | 任务玩家               |
| TARGET               | 缺省                 |
| LOCATION             | 事件方块中心             |
| TRIGGER\_ITEM / slot | 事件物品 / HAND        |
| BLOCK                | 事件方块或移动终点方块        |

## `block_drop_item`

玩家破坏方块产生掉落事件时触发，保留破坏前 BlockState。

| 上下文                  | 值                    |
| -------------------- | -------------------- |
| 事件/载荷                | `BlockDropItemEvent` |
| 可用性                  | Paper 和 Spigot       |
| PLAYER               | 此事件关联的玩家             |
| SOURCE               | 任务玩家                 |
| TARGET               | 缺省                   |
| LOCATION             | 事件方块中心               |
| TRIGGER\_ITEM / slot | 当前主手 / HAND          |
| BLOCK                | 事件方块或移动终点方块          |
| 附加数据                 | `broken_block_state` |

## `block_place`

玩家放置方块时触发，此触发器默认不排除玩家放置。

| 上下文                  | 值                 |
| -------------------- | ----------------- |
| 事件/载荷                | `BlockPlaceEvent` |
| 可用性                  | Paper 和 Spigot    |
| PLAYER               | 此事件关联的玩家          |
| SOURCE               | 任务玩家              |
| TARGET               | 缺省                |
| LOCATION             | 事件方块中心            |
| TRIGGER\_ITEM / slot | 放置物品 / 事件手        |
| BLOCK                | 事件方块或移动终点方块       |

## `block_break_progress_update`

观察玩家挖掘进度更新。

| 上下文                  | 值                               |
| -------------------- | ------------------------------- |
| 事件/载荷                | `BlockBreakProgressUpdateEvent` |
| 可用性                  | 需 Paper 模式及对应事件类                |
| PLAYER               | 此事件关联的玩家                        |
| SOURCE               | 任务玩家                            |
| TARGET               | 缺省                              |
| LOCATION             | 事件方块中心                          |
| TRIGGER\_ITEM / slot | 主手 / HAND                       |
| BLOCK                | 事件方块或移动终点方块                     |
| 附加数据                 | `block_break_progress`          |

## `interact`

玩家交互时触发，点击方块/物品/手可能缺省。

| 上下文                  | 值                     |
| -------------------- | --------------------- |
| 事件/载荷                | `PlayerInteractEvent` |
| 可用性                  | Paper 和 Spigot        |
| PLAYER               | 此事件关联的玩家              |
| SOURCE               | 任务玩家                  |
| TARGET               | 缺省                    |
| LOCATION             | 点击方块中心，否则玩家位置         |
| TRIGGER\_ITEM / slot | 事件物品 / 事件手，均可缺省       |
| BLOCK                | 事件方块或移动终点方块           |

## `inside_block`

观察玩家处于方块内部事件。

| 上下文                  | 值                        |
| -------------------- | ------------------------ |
| 事件/载荷                | `EntityInsideBlockEvent` |
| 可用性                  | 需 Paper 模式及对应事件类         |
| PLAYER               | 此事件关联的玩家                 |
| SOURCE               | 任务玩家                     |
| TARGET               | 缺省                       |
| LOCATION             | 事件方块中心                   |
| TRIGGER\_ITEM / slot | 缺省                       |
| BLOCK                | 事件方块或移动终点方块              |

## `vibration_receive`

振动事件来源实体为玩家时触发。

| 上下文                  | 值                       |
| -------------------- | ----------------------- |
| 事件/载荷                | `BlockReceiveGameEvent` |
| 可用性                  | Paper 和 Spigot          |
| PLAYER               | 此事件关联的玩家                |
| SOURCE               | 任务玩家                    |
| TARGET               | 任务玩家                    |
| LOCATION             | 接收方块位置                  |
| TRIGGER\_ITEM / slot | 缺省                      |

[触发器概览](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers.md) · [事件条件](/ultimatequest-zhong-wen-wen-dang/pei-zhi/conditions.md)