# 所有触发器

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

触发器的值可以通过 `%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>