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

# 战斗、伤害与死亡触发器

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

## 配置示例

```yaml
source:
  trigger: attack
  amount: 10
```

## `attack`

可归属于攻击玩家的伤害触发，包括可归属弹射物。

| 上下文                  | 值                                 |
| -------------------- | --------------------------------- |
| 事件/载荷                | `EntityDamageByEntityEvent`       |
| 可用性                  | Paper 和 Spigot                    |
| PLAYER               | 此事件关联的玩家                          |
| SOURCE               | 任务玩家                              |
| TARGET               | 受伤/尝试攻击目标                         |
| LOCATION             | 目标/实体位置                           |
| TRIGGER\_ITEM / slot | 近战主手、三叉戟物品或跟踪发射武器/槽               |
| 附加数据                 | `original_damage`, `damage_cause` |

## `melee_attack`

仅直接伤害者为玩家时触发，不含弹射物伤害。

| 上下文                  | 值                                                    |
| -------------------- | ---------------------------------------------------- |
| 事件/载荷                | `EntityDamageByEntityEvent`                          |
| 可用性                  | Paper 和 Spigot                                       |
| PLAYER               | 此事件关联的玩家                                             |
| SOURCE               | 任务玩家                                                 |
| TARGET               | 受伤/尝试攻击目标                                            |
| LOCATION             | 目标/实体位置                                              |
| TRIGGER\_ITEM / slot | 主手 / HAND                                            |
| 附加数据                 | `original_damage`, `attack_cooldown`, `damage_cause` |

## `damage`

玩家受伤时触发，包括环境伤害。

| 上下文                  | 值                                                                        |
| -------------------- | ------------------------------------------------------------------------ |
| 事件/载荷                | `EntityDamageEvent`                                                      |
| 可用性                  | Paper 和 Spigot                                                           |
| PLAYER               | 此事件关联的玩家                                                                 |
| SOURCE               | 已解析攻击者，环境伤害可缺省                                                           |
| TARGET               | 任务玩家                                                                     |
| LOCATION             | 玩家位置                                                                     |
| TRIGGER\_ITEM / slot | 缺省                                                                       |
| 附加数据                 | `original_damage`, `damage_cause`, `damage_by_entity`, `damage_by_block` |

## `damage_by_entity`

玩家受到实体伤害时触发。

| 上下文                  | 值                                                                        |
| -------------------- | ------------------------------------------------------------------------ |
| 事件/载荷                | `EntityDamageByEntityEvent`                                              |
| 可用性                  | Paper 和 Spigot                                                           |
| PLAYER               | 此事件关联的玩家                                                                 |
| SOURCE               | 已解析攻击者或直接伤害者                                                             |
| TARGET               | 任务玩家                                                                     |
| LOCATION             | 玩家位置                                                                     |
| TRIGGER\_ITEM / slot | 缺省                                                                       |
| 附加数据                 | `original_damage`, `damage_cause`, `damage_by_entity`, `damage_by_block` |

## `kill`

死亡归属玩家击杀者时触发，无归属玩家时不发出任务事件。

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

## `death`

死亡实体为玩家时触发，属于受害者侧进度。

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

## `regain`

玩家回复生命时触发，统计事件次数而非回复点数。

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

## `shield_block`

通过实际盾牌格挡专用路由触发，不重复订阅通用伤害。

| 上下文                  | 值                                                     |
| -------------------- | ----------------------------------------------------- |
| 事件/载荷                | `EntityDamageByEntityEvent`                           |
| 可用性                  | Paper 和 Spigot                                        |
| PLAYER               | 此事件关联的玩家                                              |
| SOURCE               | 已解析攻击者或直接伤害者                                          |
| TARGET               | 任务玩家                                                  |
| LOCATION             | 玩家位置                                                  |
| TRIGGER\_ITEM / slot | 缺省                                                    |
| 附加数据                 | `original_damage`, `damage_cause`, `damage_by_entity` |

## `shield_disable`

玩家盾牌被禁用时触发。

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

## `attempt_smash_attack`

玩家尝试重击且事件结果不是 DENY 时触发。

| 上下文                  | 值                               |
| -------------------- | ------------------------------- |
| 事件/载荷                | `EntityAttemptSmashAttackEvent` |
| 可用性                  | 需 Paper 模式及对应事件类                |
| PLAYER               | 此事件关联的玩家                        |
| SOURCE               | 任务玩家                            |
| TARGET               | 受伤/尝试攻击目标                       |
| LOCATION             | 目标/实体位置                         |
| TRIGGER\_ITEM / slot | 事件武器 / HAND                     |

## `knockback`

观察玩家击退，事件提供时来源为推挤实体，否则为玩家。

| 上下文                  | 值                      |
| -------------------- | ---------------------- |
| 事件/载荷                | `EntityKnockbackEvent` |
| 可用性                  | 需 Paper 模式及对应事件类       |
| PLAYER               | 此事件关联的玩家               |
| SOURCE               | 事件提供的推挤实体，否则为玩家        |
| TARGET               | 任务玩家                   |
| LOCATION             | 玩家位置                   |
| TRIGGER\_ITEM / slot | 缺省                     |

## `combust`

玩家开始燃烧时触发。

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

## `creeper_explode`

爆炸准备时如能关联玩家则触发，通常为苦力怕目标玩家。

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

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