> 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/cn-er/pei-zhi/triggers/targeting-special.md).

# 目标与特殊实体触发器

这些触发器涵盖怪物选择目标、苦力怕进入爆炸准备、幻翼预生成以及监守者愤怒值变化。

下方每个触发器部分都会说明当前实现所创建的运行时上下文。

| 上下文                             | 含义                                                     |
| ------------------------------- | ------------------------------------------------------ |
| `PLAYER`                        | 正在检查其激活附魔的玩家。                                          |
| `SOURCE`                        | 对事件负责的行为主体或所有者。                                        |
| `SKILL`                         | 直接载体或中间实体，例如投射物、鱼钩、烟花或监守者。                             |
| `TARGET`                        | 最终受到影响或被检查的实体。部分事件中可能不存在。                              |
| `BLOCK`                         | 触发器提供的事件方块。                                            |
| `LOCATION`                      | 供位置相关条件和能力使用的主要事件位置。                                   |
| `TRIGGER_ITEM` / `TRIGGER_SLOT` | 选中当前激活附魔的物品和装备槽位。                                      |
| `EVENT`                         | 底层 Bukkit/Paper 事件。未复制到其他字段的触发器专用状态，仍可由事件感知型实现通过该事件访问。 |

当某个角色标记为**玩家**时，它会解析为与 `PLAYER` 相同的实体。缺失的角色会解析为 `null`；需要该角色的条件或能力会安全失败或被跳过。

## `on-target`

当某个实体将玩家选为目标时执行。

| 上下文                 | 值                                               |
| ------------------- | ----------------------------------------------- |
| `PLAYER` / `TARGET` | 被选为目标的玩家                                        |
| `SOURCE` / `SKILL`  | 正在选择目标的实体                                       |
| `LOCATION`          | 玩家所在位置                                          |
| 额外上下文               | `target_reason`、`target_count`；取消能力会移除已经记录的目标关系 |

## `on-untag`

当一个先前被记录为正在攻击玩家的实体，将目标改为非玩家实体或清除目标时执行。

| 上下文                 | 值               |
| ------------------- | --------------- |
| `PLAYER` / `TARGET` | 先前被选为目标的玩家      |
| `SOURCE` / `SKILL`  | 停止将该玩家作为目标的实体   |
| `LOCATION`          | 玩家所在位置          |
| 额外上下文               | `target_reason` |

## `on-creeper-explode`

当爆炸准备事件中的实体是玩家，或是当前正将某个玩家作为目标的苦力怕时执行。

| 上下文                 | 值                          |
| ------------------- | -------------------------- |
| `PLAYER` / `TARGET` | 玩家实体，或苦力怕当前锁定的玩家目标         |
| `SOURCE` / `SKILL`  | 进入爆炸准备的实体，通常为苦力怕           |
| `LOCATION`          | 进入爆炸准备的实体所在位置              |
| 额外上下文               | `original_radius`；可修改的爆炸半径 |
| 注意                  | 这不是通用爆炸触发器，也不会提供爆炸掉落倍率     |

## `on-phantom-pre-spawn`

当 Paper 的幻翼预生成事件由某个玩家引发时执行。

| 上下文                                      | 值                                  |
| ---------------------------------------- | ---------------------------------- |
| `PLAYER` / `SOURCE` / `SKILL` / `TARGET` | 原本将为其生成幻翼的玩家                       |
| `LOCATION` / `BLOCK`                     | 计划生成的位置及该位置的方块                     |
| 额外行为                                     | 取消能力会将 `shouldAbortSpawn` 设置为 true |

## `on-warden-anger-change`

当 Paper 报告监守者对某个玩家的愤怒值发生变化时执行。

| 上下文                 | 值                                                                     |
| ------------------- | --------------------------------------------------------------------- |
| `PLAYER` / `SOURCE` | 作为监守者愤怒目标的玩家                                                          |
| `SKILL` / `TARGET`  | 监守者                                                                   |
| `LOCATION`          | 监守者所在位置                                                               |
| 额外上下文               | 旧愤怒值和新愤怒值仍保留在 `WardenAngerChangeEvent` 中；提供可修改的 `warden_anger` 修改器上下文 |