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

# Movement and Input Triggers

These triggers expose player movement or input state. High-frequency powers should use strict conditions and conservative abilities.

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-move`

Runs only when `PlayerMoveEvent.hasChangedBlock()` is true.

| Context                                  | Value                              |
| ---------------------------------------- | ---------------------------------- |
| `PLAYER` / `SOURCE` / `SKILL` / `TARGET` | moving player                      |
| `FROM` / `TO`                            | Previous and destination locations |
| `LOCATION`                               | Destination location               |
| `BLOCK`                                  | Block at the destination           |

## `on-input`

Runs when Paper reports a player input update.

| Context                                  | Value                                                                                             |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `PLAYER` / `SOURCE` / `SKILL` / `TARGET` | player                                                                                            |
| Extra context                            | Forward, backward, left, right, jump, sprint, and sneak input state remains on `PlayerInputEvent` |

## `on-jump`

Runs for Paper's player jump event.

| Context                                  | Value                      |
| ---------------------------------------- | -------------------------- |
| `PLAYER` / `SOURCE` / `SKILL` / `TARGET` | jumping player             |
| `FROM` / `TO`                            | Jump start and destination |
| `LOCATION`                               | Destination                |
| `BLOCK`                                  | Block at the destination   |

## `on-toggle-flight`

Runs when a player toggles flight.

| Context                                  | Value                                                                                                |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `PLAYER` / `SOURCE` / `SKILL` / `TARGET` | player                                                                                               |
| Extra context                            | New flight state remains on `PlayerToggleFlightEvent`; cancellation is applied to cancellable events |

## `on-toggle-sneak`

Runs when a player toggles sneaking.

| Context                                  | Value                                               |
| ---------------------------------------- | --------------------------------------------------- |
| `PLAYER` / `SOURCE` / `SKILL` / `TARGET` | player                                              |
| Extra context                            | New sneak state remains on `PlayerToggleSneakEvent` |