> 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/items-equipment.md).

# 物品、附魔与装备触发器

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

## 配置示例

```yaml
source:
  trigger: consume
  amount: 10
```

## `consume`

玩家消耗物品时触发，使用被消耗物品作为上下文。

| 上下文                  | 值                        |
| -------------------- | ------------------------ |
| 事件/载荷                | `PlayerItemConsumeEvent` |
| 可用性                  | Paper 和 Spigot           |
| PLAYER               | 此事件关联的玩家                 |
| SOURCE               | 任务玩家                     |
| TARGET               | 缺省                       |
| LOCATION             | 玩家位置                     |
| TRIGGER\_ITEM / slot | 被消耗物品堆 / 事件手             |

## `enchant_item`

附魔台为物品附魔时触发，不是铁砧合并。

| 上下文                  | 值                                                                 |
| -------------------- | ----------------------------------------------------------------- |
| 事件/载荷                | `EnchantItemEvent`                                                |
| 可用性                  | Paper 和 Spigot                                                    |
| PLAYER               | 此事件关联的玩家                                                          |
| SOURCE               | 任务玩家                                                              |
| TARGET               | 缺省                                                                |
| LOCATION             | 玩家位置                                                              |
| TRIGGER\_ITEM / slot | 附魔物品 / HAND                                                       |
| 附加数据                 | `original_experience`, `enchantment_level_cost`, `original_lapis` |

original\_experience 为显示等级费用，enchantment\_level\_cost 与 original\_lapis 为所选按钮索引加 1（通常 1–3），这些是上下文值，不是进度增量。

## `item_damage`

玩家物品受到耐久损耗时触发。

| 上下文                  | 值                       |
| -------------------- | ----------------------- |
| 事件/载荷                | `PlayerItemDamageEvent` |
| 可用性                  | Paper 和 Spigot          |
| PLAYER               | 此事件关联的玩家                |
| SOURCE               | 任务玩家                    |
| TARGET               | 缺省                      |
| LOCATION             | 玩家位置                    |
| TRIGGER\_ITEM / slot | 受损物品 / 解析槽              |
| 附加数据                 | `original_item_damage`  |

## `item_held`

玩家切换选中快捷栏槽时触发。

| 上下文                  | 值                     |
| -------------------- | --------------------- |
| 事件/载荷                | `PlayerItemHeldEvent` |
| 可用性                  | Paper 和 Spigot        |
| PLAYER               | 此事件关联的玩家              |
| SOURCE               | 任务玩家                  |
| TARGET               | 缺省                    |
| LOCATION             | 玩家位置                  |
| TRIGGER\_ITEM / slot | 新选中快捷栏物品 / HAND       |

## `swap_hand`

玩家交换主副手时触发，物品为事件中的新主手物品。

| 上下文                  | 值                          |
| -------------------- | -------------------------- |
| 事件/载荷                | `PlayerSwapHandItemsEvent` |
| 可用性                  | Paper 和 Spigot             |
| PLAYER               | 此事件关联的玩家                   |
| SOURCE               | 任务玩家                       |
| TARGET               | 缺省                         |
| LOCATION             | 玩家位置                       |
| TRIGGER\_ITEM / slot | 事件新主手物品 / HAND             |

## `item_group_cooldown`

观察物品/组冷却变化，只在可解析时附带具体物品。

| 上下文                  | 值                              |
| -------------------- | ------------------------------ |
| 事件/载荷                | `PlayerItemGroupCooldownEvent` |
| 可用性                  | 需 Paper 模式及对应事件类               |
| PLAYER               | 此事件关联的玩家                       |
| SOURCE               | 任务玩家                           |
| TARGET               | 缺省                             |
| LOCATION             | 玩家位置                           |
| TRIGGER\_ITEM / slot | 事件提供材质时才匹配手持物品                 |

## `name_entity`

玩家命名实体时触发。

| 上下文                  | 值                       |
| -------------------- | ----------------------- |
| 事件/载荷                | `PlayerNameEntityEvent` |
| 可用性                  | 需 Paper 模式及对应事件类        |
| 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)