> 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/for-enchantmentreform/configs/triggers/projectiles.md).

# Projectile and Ranged Triggers

These triggers separate the shooter (`SOURCE`) from the projectile or other carrier (`SKILL`).

Each trigger section below documents the runtime context created by the current implementation.

| Context                         | Meaning                                                                                                                                           |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PLAYER`                        | The player whose active enchantment is being evaluated.                                                                                           |
| `SOURCE`                        | The actor or owner responsible for the event.                                                                                                     |
| `SKILL`                         | The direct carrier/intermediate entity, such as a projectile, hook, firework, or Warden.                                                          |
| `TARGET`                        | The final affected or inspected entity. It may be unavailable for some events.                                                                    |
| `BLOCK`                         | The event block, when the trigger supplies one.                                                                                                   |
| `LOCATION`                      | The main event location used by location-aware conditions and abilities.                                                                          |
| `TRIGGER_ITEM` / `TRIGGER_SLOT` | The item and equipment slot that selected the active enchantment.                                                                                 |
| `EVENT`                         | The underlying Bukkit/Paper event. Trigger-specific state not copied into another field remains available through the event-aware implementation. |

When a role is marked **player**, it resolves to the same entity as `PLAYER`. A missing role resolves to `null`; conditions or abilities requiring it will fail or skip safely.

## `on-shoot`

Runs for `EntityShootBowEvent` when the shooter is a player.

| Context                         | Value                                                    |
| ------------------------------- | -------------------------------------------------------- |
| `PLAYER` / `SOURCE`             | shooter                                                  |
| `SKILL` / `TARGET`              | spawned projectile entity                                |
| `LOCATION`                      | Projectile location                                      |
| `TRIGGER_ITEM` / `TRIGGER_SLOT` | Bow/crossbow and event hand                              |
| Extra context                   | `bow_force`, `bow`, `consumable`, `hand`, `projectile`   |
| Difference                      | Does not start EnchantmentReform projectile continuation |

## `on-shoot-bow`

Uses the same initial context as `on-shoot`, then starts projectile tracking for the final `SKILL` entity when it is a projectile.

| Context                         | Value                                                                     |
| ------------------------------- | ------------------------------------------------------------------------- |
| `PLAYER` / `SOURCE`             | shooter                                                                   |
| `SKILL` / `TARGET`              | Original projectile, or a replacement entity returned by abilities        |
| `LOCATION`                      | Projectile location                                                       |
| `TRIGGER_ITEM` / `TRIGGER_SLOT` | Bow/crossbow and event hand                                               |
| Extra context                   | `bow_force`, `bow`, `consumable`, `hand`, `projectile`                    |
| Difference                      | Enables `on-projectile-tick` and tracked `on-projectile-hit` continuation |

## `on-load-crossbow`

Runs when a player loads a crossbow.

| Context                                  | Value                                                                           |
| ---------------------------------------- | ------------------------------------------------------------------------------- |
| `PLAYER` / `SOURCE` / `SKILL` / `TARGET` | player                                                                          |
| `TRIGGER_ITEM` / `TRIGGER_SLOT`          | Crossbow and event hand                                                         |
| Extra behavior                           | Cancelling the power can cancel/deny the underlying Paper event where supported |

## `on-projectile-launch`

Runs for a projectile launch whose shooter is a player.

| Context                         | Value                                                                   |
| ------------------------------- | ----------------------------------------------------------------------- |
| `PLAYER` / `SOURCE`             | shooter                                                                 |
| `SKILL` / `TARGET`              | launched projectile                                                     |
| `LOCATION`                      | Projectile location                                                     |
| `TRIGGER_ITEM` / `TRIGGER_SLOT` | Current main-hand item / `HAND`                                         |
| Extra context                   | `projectile`                                                            |
| Note                            | This generic launch trigger does not itself create tracked continuation |

## `on-projectile-tick`

Runs once per tick for a projectile tracked by `on-shoot-bow`.

| Context                         | Value                                             |
| ------------------------------- | ------------------------------------------------- |
| `PLAYER`                        | Player who launched/captured the projectile power |
| `SOURCE`                        | Current shooter entity                            |
| `SKILL` / `TARGET`              | Tracked projectile                                |
| `LOCATION` / `BLOCK`            | Projectile location and block at that location    |
| `TRIGGER_ITEM` / `TRIGGER_SLOT` | Captured firing item and slot                     |
| `TICK`                          | Runtime tick                                      |
| Extra context                   | `projectile`; supports `interval`                 |

## `on-projectile-hit`

Runs when a projectile hits after tracked data is resolved, or when a player-shot projectile can be resolved directly.

| Context                         | Value                                                            |
| ------------------------------- | ---------------------------------------------------------------- |
| `PLAYER`                        | Captured owner or direct player shooter                          |
| `SOURCE`                        | Resolved shooter                                                 |
| `SKILL`                         | Projectile                                                       |
| `TARGET`                        | Hit entity; missing when a block is hit                          |
| `BLOCK`                         | Hit block; missing when an entity is hit                         |
| `LOCATION`                      | Center of hit block, hit entity location, or projectile location |
| `TRIGGER_ITEM` / `TRIGGER_SLOT` | Captured firing item and slot when tracked                       |
| Extra context                   | `projectile`; tracking ends when this event is handled           |

## `on-riptide`

Runs when a player uses Riptide.

| Context                                  | Value                                      |
| ---------------------------------------- | ------------------------------------------ |
| `PLAYER` / `SOURCE` / `SKILL` / `TARGET` | player                                     |
| `TRIGGER_ITEM` / `TRIGGER_SLOT`          | Riptide item / `HAND`                      |
| Extra context                            | The `PlayerRiptideEvent` remains available |