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

# Movement and Input Triggers

Each section documents the current event context. PLAYER is the player credited with quest progress; TARGET is not automatically PLAYER. Missing values remain absent. All of these triggers observe progress and do not expose mutable damage/drop results.

## Configuration example

```yaml
source:
  trigger: move
  amount: 10
```

## `move`

Runs when block coordinates or world change. Turning or movement within the same block does not count.

| Context              | Value                                     |
| -------------------- | ----------------------------------------- |
| Event / payload      | `PlayerMoveEvent`                         |
| Availability         | Paper and Spigot                          |
| PLAYER               | Player associated with this event         |
| SOURCE               | Quest player                              |
| TARGET               | Absent                                    |
| LOCATION             | Destination; from/to also retained        |
| TRIGGER\_ITEM / slot | Absent                                    |
| BLOCK                | Event block or movement destination block |

Each accepted event contributes one, not a Euclidean distance. Use cooldown-ms to control event frequency.

## `input`

Observes a player input update; movement distance is not calculated.

| Context              | Value                             |
| -------------------- | --------------------------------- |
| Event / payload      | `PlayerInputEvent`                |
| Availability         | Paper and Spigot                  |
| PLAYER               | Player associated with this event |
| SOURCE               | Quest player                      |
| TARGET               | Absent                            |
| LOCATION             | Player location                   |
| TRIGGER\_ITEM / slot | Absent                            |

## `toggle_sneak`

Observes sneak-state transitions. Use a player-state condition for the required state.

| Context              | Value                             |
| -------------------- | --------------------------------- |
| Event / payload      | `PlayerToggleSneakEvent`          |
| Availability         | Paper and Spigot                  |
| PLAYER               | Player associated with this event |
| SOURCE               | Quest player                      |
| TARGET               | Absent                            |
| LOCATION             | Player location                   |
| TRIGGER\_ITEM / slot | Absent                            |

## `toggle_flight`

Observes both flight-state transitions; inspect the event to distinguish them.

| Context              | Value                             |
| -------------------- | --------------------------------- |
| Event / payload      | `PlayerToggleFlightEvent`         |
| Availability         | Paper and Spigot                  |
| PLAYER               | Player associated with this event |
| SOURCE               | Quest player                      |
| TARGET               | Absent                            |
| LOCATION             | Player location                   |
| TRIGGER\_ITEM / slot | Absent                            |

## `riptide`

Runs when a player uses Riptide with an item.

| Context              | Value                             |
| -------------------- | --------------------------------- |
| Event / payload      | `PlayerRiptideEvent`              |
| Availability         | Paper and Spigot                  |
| PLAYER               | Player associated with this event |
| SOURCE               | Quest player                      |
| TARGET               | Absent                            |
| LOCATION             | Player location                   |
| TRIGGER\_ITEM / slot | Event item / HAND                 |

## `jump`

Observes a player jump with origin and destination positions.

| Context              | Value                                     |
| -------------------- | ----------------------------------------- |
| Event / payload      | `PlayerJumpEvent`                         |
| Availability         | Paper mode and event class required       |
| PLAYER               | Player associated with this event         |
| SOURCE               | Quest player                              |
| TARGET               | Absent                                    |
| LOCATION             | Destination; from/to also retained        |
| TRIGGER\_ITEM / slot | Absent                                    |
| BLOCK                | Event block or movement destination block |

## `elytra_boost`

Runs when a player uses an elytra boost.

| Context              | Value                               |
| -------------------- | ----------------------------------- |
| Event / payload      | `PlayerElytraBoostEvent`            |
| Availability         | Paper mode and event class required |
| PLAYER               | Player associated with this event   |
| SOURCE               | Quest player                        |
| TARGET               | Quest player                        |
| LOCATION             | Player location                     |
| TRIGGER\_ITEM / slot | Boost item / event hand             |

## `lunge`

Observes a player lunge and attempts to retain the active item.

| Context              | Value                                                         |
| -------------------- | ------------------------------------------------------------- |
| Event / payload      | `EntityLungeEvent`                                            |
| Availability         | Paper mode and event class required                           |
| PLAYER               | Player associated with this event                             |
| SOURCE               | Quest player                                                  |
| TARGET               | Absent                                                        |
| LOCATION             | Player location                                               |
| TRIGGER\_ITEM / slot | Active item when available, otherwise implementation fallback |

[Trigger overview](/for-ultimatequest/configuration/triggers.md) · [Event conditions](/for-ultimatequest/configuration/conditions.md)