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

# 移动与输入触发器

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

## 配置示例

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

## `move`

方块坐标或世界变化时触发，同格移动/转头不计数。

| 上下文                  | 值                 |
| -------------------- | ----------------- |
| 事件/载荷                | `PlayerMoveEvent` |
| 可用性                  | Paper 和 Spigot    |
| PLAYER               | 此事件关联的玩家          |
| SOURCE               | 任务玩家              |
| TARGET               | 缺省                |
| LOCATION             | 终点，另保留 from/to    |
| TRIGGER\_ITEM / slot | 缺省                |
| BLOCK                | 事件方块或移动终点方块       |

每次通过事件贡献 1，不是欧氏距离，可用 cooldown-ms 控制频率。

## `input`

观察玩家输入更新，不计算移动距离。

| 上下文                  | 值                  |
| -------------------- | ------------------ |
| 事件/载荷                | `PlayerInputEvent` |
| 可用性                  | Paper 和 Spigot     |
| PLAYER               | 此事件关联的玩家           |
| SOURCE               | 任务玩家               |
| TARGET               | 缺省                 |
| LOCATION             | 玩家位置               |
| TRIGGER\_ITEM / slot | 缺省                 |

## `toggle_sneak`

观察潜行状态切换，可用玩家状态条件限制所需状态。

| 上下文                  | 值                        |
| -------------------- | ------------------------ |
| 事件/载荷                | `PlayerToggleSneakEvent` |
| 可用性                  | Paper 和 Spigot           |
| PLAYER               | 此事件关联的玩家                 |
| SOURCE               | 任务玩家                     |
| TARGET               | 缺省                       |
| LOCATION             | 玩家位置                     |
| TRIGGER\_ITEM / slot | 缺省                       |

## `toggle_flight`

观察飞行状态切换，具体开启/关闭需读取事件。

| 上下文                  | 值                         |
| -------------------- | ------------------------- |
| 事件/载荷                | `PlayerToggleFlightEvent` |
| 可用性                  | Paper 和 Spigot            |
| PLAYER               | 此事件关联的玩家                  |
| SOURCE               | 任务玩家                      |
| TARGET               | 缺省                        |
| LOCATION             | 玩家位置                      |
| TRIGGER\_ITEM / slot | 缺省                        |

## `riptide`

玩家用物品发动激流时触发。

| 上下文                  | 值                    |
| -------------------- | -------------------- |
| 事件/载荷                | `PlayerRiptideEvent` |
| 可用性                  | Paper 和 Spigot       |
| PLAYER               | 此事件关联的玩家             |
| SOURCE               | 任务玩家                 |
| TARGET               | 缺省                   |
| LOCATION             | 玩家位置                 |
| TRIGGER\_ITEM / slot | 事件物品 / HAND          |

## `jump`

观察玩家跳跃并提供起止位置。

| 上下文                  | 值                 |
| -------------------- | ----------------- |
| 事件/载荷                | `PlayerJumpEvent` |
| 可用性                  | 需 Paper 模式及对应事件类  |
| PLAYER               | 此事件关联的玩家          |
| SOURCE               | 任务玩家              |
| TARGET               | 缺省                |
| LOCATION             | 终点，另保留 from/to    |
| TRIGGER\_ITEM / slot | 缺省                |
| BLOCK                | 事件方块或移动终点方块       |

## `elytra_boost`

玩家进行鞘翅加速时触发。

| 上下文                  | 值                        |
| -------------------- | ------------------------ |
| 事件/载荷                | `PlayerElytraBoostEvent` |
| 可用性                  | 需 Paper 模式及对应事件类         |
| PLAYER               | 此事件关联的玩家                 |
| SOURCE               | 任务玩家                     |
| TARGET               | 任务玩家                     |
| LOCATION             | 玩家位置                     |
| TRIGGER\_ITEM / slot | 加速物品 / 事件手               |

## `lunge`

观察玩家突进并尝试保留正在使用物品。

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