# 所有触发器

价格获得消耗触发效果需要触发器来激活它们，永久效果则不需要，永久效果会一直被执行。

触发器的值可以通过 `%v%` 变量符得到，并使用在效果的参数中。

<table><thead><tr><th>ID</th><th width="249.33333333333331">描述</th><th>提供的值</th></tr></thead><tbody><tr><td><code>alt_click</code></td><td>大部分物品手持右键时触发，但如果该物品右键有其他功能（例如弓的射箭），则为左键。</td><td>1</td></tr><tr><td><code>bite</code></td><td>钓鱼时有鱼咬钩时触发。</td><td>1</td></tr><tr><td><code>block_item_drop</code></td><td>捡起挖掘方块掉落的掉落物时触发。</td><td>掉落物数量</td></tr><tr><td><code>bow_attack</code></td><td>弓、弩攻击到实体时触发</td><td>造成的伤害</td></tr><tr><td><code>cast_rod</code></td><td>钓鱼抛竿时触发。</td><td>1</td></tr><tr><td><code>catch_entity</code></td><td>咬钩时成功钓到实体时触发。（*不同于 bite 咬钩，这里是成功钓上战利品！）</td><td>1</td></tr><tr><td><code>catch_fish</code></td><td>咬钩时成功钓到鱼儿时触发。（*不同于 bite 咬钩，这里是成功钓上战利品！）</td><td>获得的经验值</td></tr><tr><td><code>catch_fish_fail</code></td><td>咬钩时未能成功钓到鱼时触发。</td><td>1</td></tr><tr><td><code>hook_in_ground</code></td><td>陆地上抛竿时触发。</td><td>1</td></tr><tr><td><code>reel_in</code></td><td>收杆时触发。</td><td>1</td></tr><tr><td><code>consume</code></td><td>消耗物品时触发。（*例如吃食物）</td><td>1</td></tr><tr><td><code>craft</code></td><td>合成物品时触发。</td><td>1</td></tr><tr><td><code>damage_item</code></td><td>消耗物品耐久时触发。</td><td>消耗的耐久值（*使用自定义耐久插件的原理是按比例取消消耗的耐久，可能与此类插件存在部分问题，需要特别考虑）</td></tr><tr><td><code>death</code></td><td>死亡时触发。</td><td>1</td></tr><tr><td><code>enchant_item</code></td><td>物品附魔时触发。</td><td>消耗的经验值</td></tr><tr><td><code>enchant_%type%</code></td><td>物品附魔指定物品类型时触发。将 <code>%type%</code> 替换为你的附魔类型 <strong>id</strong>。<strong>需要 EcoEnchants。</strong></td><td>消耗的经验值</td></tr><tr><td><code>entity_item_drop</code></td><td>捡起击杀实体掉落掉落物时触发。</td><td>掉落物数量</td></tr><tr><td><code>fall_damage</code></td><td>有摔落伤害时触发。</td><td>伤害值</td></tr><tr><td><code>gain_hunger</code></td><td>获得饱食度时触发。</td><td>获得的饱食度值</td></tr><tr><td><code>gain_pet_xp</code></td><td>获得宠物经验值时触发。<strong>需要 EcoPets。</strong></td><td>获得的经验值</td></tr><tr><td><code>gain_skill_xp</code></td><td>获得技能经验值时触发。<strong>需要 EcoSkills。</strong></td><td>获得的经验值</td></tr><tr><td><code>gain_xp</code></td><td>获得原版经验值时触发。</td><td>获得的经验值</td></tr><tr><td><code>heal</code></td><td>回复血量时触发。</td><td>回复的血量</td></tr><tr><td><code>item_break</code></td><td>当你的背包有物品耐久为0消失时触发。</td><td>1</td></tr><tr><td><code>jump</code></td><td>当你按下空格键跳跃时触发。</td><td>1</td></tr><tr><td><code>kill</code></td><td>当击杀一个实体或者玩家时触发。</td><td>目标的最高血量</td></tr><tr><td><code>kill_boss</code></td><td>当击杀一个 Boss 时触发。<strong>需要 EcoBosses。</strong></td><td>Boss 的最高血量</td></tr><tr><td><code>level_up_pet</code></td><td>宠物升级时触发。<strong>需要 EcoPets。</strong></td><td>新等级</td></tr><tr><td><code>level_up_skill</code></td><td>技能升级时触发。<strong>需要 EcoSkills。</strong></td><td>新等级</td></tr><tr><td><code>lose_hunger</code></td><td>消耗饱食度时触发。</td><td>消耗的饱食度</td></tr><tr><td><code>lose_potion_effect</code></td><td>当某个药水效果失效时触发。</td><td>1</td></tr><tr><td><code>melee_attack</code></td><td>近战攻击时触发。</td><td>造成的伤害</td></tr><tr><td><code>mine_block</code></td><td>挖掘方块后触发。</td><td>1</td></tr><tr><td><code>mine_block_progress</code></td><td>正在挖掘方块时触发。</td><td>1</td></tr><tr><td><code>move</code></td><td>动一下就触发，包括转向。</td><td>移动距离格数</td></tr><tr><td><code>potion_effect</code></td><td>获得药水效果时触发。</td><td>1</td></tr><tr><td><code>projectile_hit</code></td><td>抛掷物（如箭、鸡蛋、雪球等）击中实体或者方块时触发。</td><td>1</td></tr><tr><td><code>projectile_launch</code></td><td>抛掷物（如箭、鸡蛋、雪球等）发射时触发。</td><td>1</td></tr><tr><td><code>shield_block</code></td><td>使用盾阻挡伤害时触发。</td><td>抵挡的伤害</td></tr><tr><td><code>spawn_boss</code></td><td>当某个 Boss 生成时触发，<strong>需要 EcoBosses。</strong></td><td>1</td></tr><tr><td><code>static_%interval%</code></td><td>每隔一段时间后触发。将 <code>%interval%</code> 替换为时长间隔值，以 <strong>tick</strong> 为单位。</td><td>1</td></tr><tr><td><code>swap_hands</code></td><td>切主副手物品时触发。</td><td>1</td></tr><tr><td><code>swing</code></td><td>游泳时触发。<strong>需要 Paper。</strong></td><td>1</td></tr><tr><td><code>take_damage</code></td><td>受到伤害时触发。</td><td>受到的伤害</td></tr><tr><td><code>take_entity_damage</code></td><td>同上，只有实体对玩家造成的伤害。</td><td>受到的伤害</td></tr><tr><td><code>toggle_flight</code></td><td>切换飞行状态时触发。</td><td>1</td></tr><tr><td><code>toggle_sneak</code></td><td>切换潜行状态时触发。</td><td>1</td></tr><tr><td><code>toggle_sprint</code></td><td>切换疾跑状态时触发。</td><td>1</td></tr><tr><td><code>trident_attack</code></td><td>三叉戟攻击时触发。</td><td>造成的伤害</td></tr><tr><td><code>win_raid</code></td><td>赢得袭击时触发。</td><td>袭击等级</td></tr><tr><td><code>jobs_level_up</code></td><td>职业等级提升时触发。<strong>需要 JobsReborn。</strong></td><td>新等级</td></tr><tr><td><code>brew</code></td><td>当酿造物品时触发。</td><td>1</td></tr><tr><td><code>brew_ingredient</code></td><td>和 brew 一样，但是触发器属性中的物品是输入物品而不是结果物品。</td><td>1</td></tr><tr><td><code>smelt</code></td><td>熔炼物品时触发。</td><td>熔炼的物品数量</td></tr><tr><td><code>place_block</code></td><td>放置方块时触发。</td><td>1</td></tr><tr><td><code>level_up_job</code></td><td>职业升级时触发。<strong>需要 EcoJobs。</strong></td><td>新等级</td></tr><tr><td><code>gain_job_xp</code></td><td>获得职业经验值时触发。<strong>需要 EcoJobs。</strong></td><td>获得的经验值</td></tr><tr><td><code>breed</code></td><td>当繁殖生物时触发。</td><td>获得的经验值</td></tr><tr><td><code>join_job</code></td><td>当加入职业时触发。*如果要筛选技能，可以使用 <code>job</code> 筛选。<strong>需要 EcoJobs。</strong></td><td>职业等级</td></tr><tr><td><code>leave_job</code></td><td>当离开职业时触发。*如果要筛选技能，可以使用 <code>job</code> 筛选。<strong>需要 EcoJobs。</strong></td><td>职业等级</td></tr><tr><td><code>sell_item</code></td><td>当在商店出售物品时触发。*支持的商店插件可见兼容插件一节。</td><td>价格</td></tr><tr><td><code>buy_item</code></td><td>当在商店购买物品时触发。<strong>需要 EcoShop。</strong></td><td>价格</td></tr><tr><td><code>headshot</code></td><td>使用远程武器击打到对象的头时触发。（即爆头）</td><td>造成的伤害</td></tr><tr><td><code>join</code></td><td>加入服务器时触发。</td><td>1</td></tr><tr><td><code>leave</code></td><td>离开服务器时触发。</td><td>1</td></tr><tr><td><code>respawn</code></td><td>重生时触发。</td><td>1</td></tr><tr><td><code>level_up_xp</code></td><td>原版经验条升级时触发。</td><td>新等级</td></tr><tr><td><code>change_world</code></td><td>切换世界时触发。</td><td>1</td></tr><tr><td><code>change_armor</code></td><td>切换盔甲时促发。</td><td>1</td></tr><tr><td><code>hold_item</code></td><td>更换手上物品时触发。</td><td>1</td></tr><tr><td><code>send_message</code></td><td>发送消息时触发。</td><td>1</td></tr><tr><td><code>pick_up_item</code></td><td>捡起物品时触发。</td><td>物品的数量</td></tr><tr><td><code>drop_item</code></td><td>丢弃物品时触发。</td><td>物品的数量</td></tr><tr><td><code>entity_target</code></td><td>敌对实体敌对玩家时触发。</td><td>1</td></tr><tr><td><code>enter_bed</code></td><td>上床时触发。</td><td>1</td></tr><tr><td><code>leave_bed</code></td><td>离开床时触发。</td><td>1</td></tr><tr><td><code>villager_trade</code></td><td>村民交易时触发。<strong>需要 Paper。</strong></td><td>获得的经验值</td></tr><tr><td><code>fill_bucket</code></td><td>装满水或熔岩时。</td><td>1</td></tr><tr><td><code>empty_bucket</code></td><td>放置水或者熔岩时。</td><td>1</td></tr><tr><td><code>shear_entity</code></td><td>剪羊毛触发。</td><td>1</td></tr><tr><td><code>enable</code></td><td>当某个物品、附魔等的效果开始生效时。</td><td>1</td></tr><tr><td><code>disable</code></td><td>当某个物品、附魔等的效果不再生效时。</td><td>1</td></tr><tr><td><code>teleport</code></td><td>传送时触发。</td><td>1</td></tr><tr><td><code>run_command</code></td><td>执行指令时触发。</td><td>1</td></tr><tr><td><code>click_entity</code></td><td>右键实体时触发。</td><td>1</td></tr><tr><td><code>click_block</code></td><td>右键方块时触发。</td><td>1</td></tr><tr><td><code>enter_region</code></td><td>进入区域时触发。<strong>需要 WorldGuard。</strong></td><td>1</td></tr><tr><td><code>leave_region</code></td><td>离开区域时触发。<strong>需要 WorldGuard。</strong></td><td>1</td></tr><tr><td><code>level_up_item</code></td><td>物品等级提升时触发。</td><td>新等级</td></tr><tr><td><code>tame_animal</code></td><td>驯服生物时触发。</td><td>1</td></tr><tr><td><code>complete_quest</code></td><td>完成任务时触发。<strong>需要 EcoQuests。</strong></td><td>1</td></tr><tr><td><code>complete_task</code></td><td>完成目标时触发。<strong>需要 EcoQuests。</strong></td><td>1</td></tr><tr><td><code>gain_task_xp</code></td><td>获得任务经验值时触发。<strong>需要 EcoQuests。</strong></td><td>获得的经验值</td></tr><tr><td><code>start_quest</code></td><td>开始任务时触发。<strong>需要 EcoQuests。</strong></td><td>1</td></tr><tr><td><code>left_click_npc</code></td><td>左键 NPC 时触发。<strong>需要 Citizens。</strong></td><td>1</td></tr><tr><td><code>right_click_npc</code></td><td>右键 NPC 时触发。<strong>需要 Citizens。</strong></td><td>1</td></tr><tr><td><code>regen_magic</code></td><td>回复魔法时触发。<strong>需要 EcoSkills。</strong></td><td>1</td></tr><tr><td>*<code>deploy_elytra</code></td><td>鞘翅展开时触发。</td><td>1</td></tr><tr><td><code>shoot_bow</code></td><td>拉弓时触发。</td><td>弓的拉开长度，是0到1的中间值</td></tr><tr><td>*<code>drink</code></td><td>喝下煲类食物或者药水时触发。</td><td>1</td></tr><tr><td>*<code>leash_entity</code></td><td>拴着实体时触发。</td><td>1</td></tr><tr><td><code>complete_advancement</code></td><td>完成成就时触发。</td><td>1</td></tr><tr><td><code>smith_item</code></td><td>锻造物品时触发。</td><td>1</td></tr><tr><td>*<code>beacon_effect</code></td><td>获得信标效果时触发。<strong>需要 Paper。</strong></td><td>1</td></tr><tr><td>*<code>elytra_boost</code></td><td>加速鞘翅时触发。<strong>需要 Paper。</strong></td><td>1</td></tr></tbody></table>

以下是新增的实体类触发器：

<table data-header-hidden><thead><tr><th width="249.33333333333331">ID</th><th>描述</th><th>提供的值</th></tr></thead><tbody><tr><td><code>entity_break_door</code></td><td>实体破坏门时触发。</td><td>1</td></tr><tr><td><code>entity_catch_fire_from_block</code></td><td>实体踩在方块上着火时触发。</td><td>1</td></tr><tr><td><code>entity_catch_fire_from_entity</code></td><td>实体被其他实体着火时触发。</td><td>1</td></tr><tr><td><code>entity_damage</code></td><td>实体受到伤害时触发。</td><td>受到的伤害</td></tr><tr><td><code>entity_damage_by_entity</code></td><td>实体被其他实体伤害时触发。</td><td>受到的伤害</td></tr><tr><td><code>entity_death</code></td><td>实体死亡时触发。</td><td>1</td></tr><tr><td><code>entity_spawn</code></td><td>实体生成时触发。</td><td>1</td></tr><tr><td><code>entity_teleport</code></td><td>实体传送时触发。</td><td>1</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.superiormc.cn/auxilor-plugins/zi-ding-yi-xiao-guo/suo-you-chu-fa-qi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
