> 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/player-state.md).

# 效果、空气、饥饿与经验触发器

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

## 配置示例

```yaml
source:
  trigger: air_change
  amount: 10
```

## `air_change`

玩家剩余空气值变化时触发。

| 上下文                  | 值                              |
| -------------------- | ------------------------------ |
| 事件/载荷                | `EntityAirChangeEvent`         |
| 可用性                  | Paper 和 Spigot                 |
| PLAYER               | 此事件关联的玩家                       |
| SOURCE               | 任务玩家                           |
| TARGET               | 缺省                             |
| LOCATION             | 玩家位置                           |
| TRIGGER\_ITEM / slot | 缺省                             |
| 附加数据                 | `original_air`, `previous_air` |

## `food_level_change`

玩家饥饿值变化时触发。

| 上下文                  | 值                      |
| -------------------- | ---------------------- |
| 事件/载荷                | `FoodLevelChangeEvent` |
| 可用性                  | Paper 和 Spigot         |
| PLAYER               | 此事件关联的玩家               |
| SOURCE               | 任务玩家                   |
| TARGET               | 缺省                     |
| LOCATION             | 玩家位置                   |
| TRIGGER\_ITEM / slot | 缺省                     |
| 附加数据                 | `original_food_level`  |

## `exp_change`

玩家经验变化时触发，统计事件次数而非经验单位。

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

## `potion_effect`

玩家药水效果变化时触发，时长来自变化效果。

| 上下文                  | 值                         |
| -------------------- | ------------------------- |
| 事件/载荷                | `EntityPotionEffectEvent` |
| 可用性                  | Paper 和 Spigot            |
| PLAYER               | 此事件关联的玩家                  |
| SOURCE               | 任务玩家                      |
| TARGET               | 任务玩家                      |
| LOCATION             | 玩家位置                      |
| TRIGGER\_ITEM / slot | 缺省                        |
| 附加数据                 | `original_duration`       |

## `effect_tick`

观察玩家效果 tick 事件，具体效果数据保留在事件中。

| 上下文                  | 值                       |
| -------------------- | ----------------------- |
| 事件/载荷                | `EntityEffectTickEvent` |
| 可用性                  | 需 Paper 模式及对应事件类        |
| PLAYER               | 此事件关联的玩家                |
| SOURCE               | 任务玩家                    |
| TARGET               | 缺省                      |
| LOCATION             | 玩家位置                    |
| TRIGGER\_ITEM / slot | 缺省                      |

## `exhaustion`

对应事件类可用时观察玩家消耗度事件。

| 上下文                  | 值                       |
| -------------------- | ----------------------- |
| 事件/载荷                | `EntityExhaustionEvent` |
| 可用性                  | 各模式按可选事件类检测             |
| PLAYER               | 此事件关联的玩家                |
| SOURCE               | 任务玩家                    |
| TARGET               | 缺省                      |
| LOCATION             | 玩家位置                    |
| TRIGGER\_ITEM / slot | 缺省                      |

## `pickup_experience`

玩家拾取经验球时触发。

| 上下文                  | 值                             |
| -------------------- | ----------------------------- |
| 事件/载荷                | `PlayerPickupExperienceEvent` |
| 可用性                  | 需 Paper 模式及对应事件类              |
| PLAYER               | 此事件关联的玩家                      |
| SOURCE               | 任务玩家                          |
| TARGET               | 缺省                            |
| LOCATION             | 经验球位置                         |
| TRIGGER\_ITEM / slot | 缺省                            |
| 附加数据                 | `original_experience`         |

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