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

# 任务触发器

触发器决定目标统计哪种玩家行为。例如，`block_break` 统计破坏方块，`kill` 统计击杀实体，`fish` 统计钓鱼。配合条件，可以进一步指定需要的方块、生物或物品。

## 基础配置

```yaml
source:
  trigger: block_place
  amount: 32
```

此目标要求放置 32 次方块。可以将它用于普通任务，其他任务类型也使用相同的来源格式，详见[目标与来源](/ultimatequest-zhong-wen-wen-dang/pei-zhi/objectives.md)。

请使用参考页中列出的小写 ID，例如 `block_place`，也可以填写完整的 `ultimatequest:block_place`。

## 进度如何统计

默认每次符合条件的事件增加一点进度。伤害事件不会自动按伤害数值累加，移动事件也不代表精确距离。钓鱼目标可以设置 `count: items`，按钓获物品的堆叠数量统计。各触发器页面会说明具体行为和可用筛选。

被取消的事件不会计数；普通任务需要先接取才开始统计。筛选目标请查看[事件条件](/ultimatequest-zhong-wen-wen-dang/pei-zhi/conditions.md)，限制重复操作请查看[防刷](/ultimatequest-zhong-wen-wen-dang/gong-neng/anti-abuse.md)。

## 平台要求

部分触发器需要 Paper 或特定服务端版本，使用前请查看对应页面的可用性说明。任务引用了不可用触发器时，请修正配置或改用受支持的触发器后再重载。

## 参考

* [Tick 与生命周期](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/lifecycle.md)：`tick`、`spawn`、`respawn`。
* [战斗与伤害](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/combat.md)：`attack`、`melee_attack`、`damage`、`damage_by_entity`、`kill`、`death`、`regain`、`shield_block`、`shield_disable`、`attempt_smash_attack`、`knockback`、`combust`、`creeper_explode`。
* [弹射物与远程](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/projectiles.md)：`projectile_launch`、`projectile_hit`、`projectile_tick`、`shoot`、`shoot_bow`、`load_crossbow`。
* [方块与交互](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/blocks-interactions.md)：`block_break`、`block_damage`、`block_drop_item`、`block_place`、`block_break_progress_update`、`interact`、`inside_block`、`vibration_receive`。
* [物品与装备](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/items-equipment.md)：`consume`、`enchant_item`、`item_damage`、`item_held`、`swap_hand`、`item_group_cooldown`、`name_entity`。
* [移动与输入](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/movement-input.md)：`move`、`input`、`toggle_sneak`、`toggle_flight`、`riptide`、`jump`、`elytra_boost`、`lunge`。
* [玩家状态](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/player-state.md)：`air_change`、`food_level_change`、`exp_change`、`potion_effect`、`effect_tick`、`exhaustion`、`pickup_experience`。
* [钓鱼与交易](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/fishing-trading.md)：`fish`、`piglin_barter`、`trade`、`purchase`。
* [目标与特殊实体](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/targeting-special.md)：`target`、`untag`、`target_tick`、`enderman_attack_player`、`phantom_pre_spawn`、`warden_anger_change`。