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

# 弹射物与远程触发器

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

## 配置示例

```yaml
source:
  trigger: projectile_launch
  amount: 10
```

## `projectile_launch`

玩家发射弹射物时触发，记录发射上下文。

| 上下文                  | 值                       |
| -------------------- | ----------------------- |
| 事件/载荷                | `ProjectileLaunchEvent` |
| 可用性                  | Paper 和 Spigot          |
| PLAYER               | 此事件关联的玩家                |
| SOURCE               | 任务玩家                    |
| TARGET               | 弹射物                     |
| LOCATION             | 弹射物位置                   |
| TRIGGER\_ITEM / slot | 已解析发射/手持物品和槽            |
| 附加数据                 | `projectile`            |

## `projectile_hit`

弹射物命中实体/方块且能关联玩家时触发。

| 上下文                  | 值                    |
| -------------------- | -------------------- |
| 事件/载荷                | `ProjectileHitEvent` |
| 可用性                  | Paper 和 Spigot       |
| PLAYER               | 此事件关联的玩家             |
| SOURCE               | 已解析射手                |
| TARGET               | 命中实体，仅方块命中时缺省        |
| LOCATION             | 弹射物位置                |
| TRIGGER\_ITEM / slot | 已知时的跟踪发射物品/槽         |
| BLOCK                | 事件方块或移动终点方块          |
| 附加数据                 | `projectile`         |

## `projectile_tick`

被跟踪弹射物及玩家/上下文有效时每 tick 触发。

| 上下文                  | 值                               |
| -------------------- | ------------------------------- |
| 事件/载荷                | `TriggerRuntime.ProjectileTick` |
| 可用性                  | Paper 和 Spigot                  |
| PLAYER               | 此事件关联的玩家                        |
| SOURCE               | 跟踪射手                            |
| TARGET               | 弹射物                             |
| LOCATION             | 弹射物位置                           |
| TRIGGER\_ITEM / slot | 跟踪发射物品/槽                        |
| BLOCK                | 事件方块或移动终点方块                     |
| 附加数据                 | `projectile`                    |

此触发器会在相关目标进行期间自动执行。

## `shoot`

观察玩家弓/弩射击路径，一次射击可同时匹配 shoot 与 shoot\_bow 目标。

| 上下文                  | 值                                                      |
| -------------------- | ------------------------------------------------------ |
| 事件/载荷                | `EntityShootBowEvent`                                  |
| 可用性                  | Paper 和 Spigot                                         |
| PLAYER               | 此事件关联的玩家                                               |
| SOURCE               | 任务玩家                                                   |
| TARGET               | 弹射物                                                    |
| LOCATION             | 弹射物位置                                                  |
| TRIGGER\_ITEM / slot | 弓/弩 / 事件手                                              |
| 附加数据                 | `bow_force`, `bow`, `consumable`, `hand`, `projectile` |

## `shoot_bow`

玩家弓/弩射击时触发，保留发射武器、手和力度。

| 上下文                  | 值                                                      |
| -------------------- | ------------------------------------------------------ |
| 事件/载荷                | `EntityShootBowEvent`                                  |
| 可用性                  | Paper 和 Spigot                                         |
| PLAYER               | 此事件关联的玩家                                               |
| SOURCE               | 任务玩家                                                   |
| TARGET               | 弹射物                                                    |
| LOCATION             | 弹射物位置                                                  |
| TRIGGER\_ITEM / slot | 弓/弩 / 事件手                                              |
| 附加数据                 | `bow_force`, `bow`, `consumable`, `hand`, `projectile` |

## `load_crossbow`

玩家装填弩时触发。

| 上下文                  | 值                         |
| -------------------- | ------------------------- |
| 事件/载荷                | `EntityLoadCrossbowEvent` |
| 可用性                  | 需 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)