触发器

近战攻击触发器 - 玩家近战攻击时触发

近战暴击触发器 - 玩家暴击攻击时触发 暴击条件：玩家正在下落且不在地面上

背刺触发器 - 攻击者在目标背后攻击时触发 通过比较攻击者与目标的朝向判定是否为背刺

空中近战攻击触发器 - 攻击者不在地面时攻击触发

横扫攻击触发器 - 玩家使用横扫攻击时触发

近战连击触发器 - 对同一目标连续攻击时触发 3秒内对同一目标的连续攻击计为连击

弓箭攻击触发器 - 弓射出的箭命中实体时触发

弩攻击触发器 - 弩射出的箭命中实体时触发

三叉戟攻击触发器 - 三叉戟命中实体时触发

弓射击触发器 - 玩家使用弓射击时触发

弩射击触发器 - 玩家使用弩射击时触发

三叉戟投掷触发器 - 玩家投出三叉戟时触发

投射物命中实体触发器 - 玩家发射的投射物命中实体时触发

投射物命中方块触发器 - 玩家发射的投射物命中方块时触发

爆头触发器 - 投射物命中目标头部时触发 通过检查投射物命中位置是否在目标眼睛位置附近判定

箭矢弹跳触发器 - 箭矢命中后反弹时触发 检查箭矢命中后是否未嵌入方块中（即发生了弹跳）

击杀触发器 - 玩家击杀任何生物时触发

击杀玩家触发器 - 玩家击杀其他玩家时触发

击杀Boss触发器 - 玩家击杀Boss级怪物时触发 Boss判定：末影龙、凋灵

连杀触发器 - 玩家在未死亡的情况下连续击杀实体时触发 使用 ConcurrentHashMap 记录每个玩家的连杀数， 玩家自身死亡（PlayerDeathEvent）时清零。

助攻触发器 - 玩家参与对实体造成伤害但不是最终击杀者时触发 记录每个被伤害实体的伤害贡献者及伤害量， 实体死亡时对所有非击杀者的玩家触发。

首杀触发器 - 服务器启动后第一次 PvP 击杀时触发

受到伤害触发器 - 玩家受到任何来源伤害时触发

受到实体伤害触发器 - 玩家被任意实体造成伤害时触发

受到玩家伤害触发器 - 玩家被其他玩家攻击（含弹射物）时触发

受到弹射物伤害触发器 - 玩家被弹射物击中时触发

摔落伤害触发器 - 玩家因摔落受伤时触发

火焰伤害触发器 - 玩家被火焰直接或燃烧持续伤害时触发

爆炸伤害触发器 - 玩家被实体或方块爆炸伤害时触发

中毒伤害触发器 - 玩家受到中毒（POISON）伤害时触发

凋零伤害触发器 - 玩家受到凋零（WITHER）伤害时触发

溺水伤害触发器 - 玩家受到溺水（DROWNING）伤害时触发

虚空伤害触发器 - 玩家掉入虚空（VOID）受到伤害时触发

魔法伤害触发器 - 玩家受到魔法（MAGIC）伤害时触发

盾牌格挡触发器 - 玩家在格挡状态下受到伤害时触发 value 为原始伤害（getDamage），altValue 为格挡掉的伤害（原始 - 最终）。

护甲吸收触发器 - 玩家受到伤害且护甲吸收了一部分伤害时触发 value 为护甲吸收量（原始 - 最终），altValue 为最终实际伤害。

在对应玩家、物品或服务器事件发生时触发。

复活触发器 - 玩家通过不死图腾等机制复活时触发

濒死触发器 - 玩家受到伤害后剩余血量低于最大血量 20% 时触发

死亡触发器 - 玩家死亡时触发

重生触发器 - 玩家重生时触发

治疗触发器 - 玩家任何来源的回血时触发

自然回血触发器 - 玩家因饱食度自然恢复生命值时触发（REGEN 或 SATIATED）

获得伤害吸收触发器 - 玩家获得 ABSORPTION（伤害吸收）药水效果时触发

挖掘方块触发器 - 玩家破坏方块时触发

挖掘进度触发器 - 玩家开始破坏方块（动画启动）时触发 注意：BlockDamageEvent 在玩家开始破坏方块时触发一次， value 简化为 1，表示开始破坏。

挖掘矿石触发器 - 玩家破坏矿石方块时触发 覆盖原版所有矿石变种：煤炭、铁、金、钻石、绿宝石、青金石、红石、铜、下界、深板岩、缟玛瑙等。

挖掘深板岩触发器 - 玩家破坏含 "DEEPSLATE" 字样的方块时触发

方块掉落物触发器 - 方块被破坏后掉落物品时触发

放置方块触发器 - 玩家放置方块时触发

破坏刷怪笼触发器 - 玩家破坏刷怪笼时触发

交互方块触发器 - 玩家右键点击方块时触发

收获触发器 - 玩家右键收获作物（甜浆果、可可豆等）时触发 使用 Paper 提供的 PlayerHarvestBlockEvent。

砍树触发器 - 玩家破坏原木类方块时触发

骨粉催熟作物触发器 - 玩家使用骨粉催熟作物时触发

种植种子触发器 - 玩家放置种子/作物方块时触发

剪羊触发器 - 玩家剪羊毛/雪傀儡等实体时触发

剪刀剪方块触发器 - 玩家使用剪刀右键剪方块（藤蔓、卷须等）时触发

繁殖动物触发器 - 玩家促成实体繁殖时触发

驯服动物触发器 - 玩家驯服实体时触发

牛奶触发器 - 玩家使用桶对牛右键挤奶时触发

堆肥触发器 - 玩家右键堆肥桶投入物品时触发

合成物品触发器 - 玩家在工作台合成物品时触发

熔炉提取触发器 - 玩家从熔炉提取产物时触发

酿造触发器 - 酿造台完成酿造时触发 由于 BrewEvent 不直接关联玩家，本实现取酿造台 inventory 的查看者中的第一个玩家。

附魔物品触发器 - 玩家在附魔台附魔物品时触发

锻造物品触发器 - 玩家在锻造台锻造装备时触发

砂轮触发器 - 玩家在砂轮取出结果物品时触发

铁砧使用触发器 - 玩家在铁砧取出结果物品时触发

织布机使用触发器 - 玩家在织布机取出结果物品时触发

制图台使用触发器 - 玩家在制图台取出结果物品时触发

切石机使用触发器 - 玩家在切石机取出结果物品时触发

修复物品触发器 - 经验修补激活时触发

村民交易触发器 - 玩家在村民交易界面选择交易时触发

出售物品触发器 - 外部经济插件驱动 需要外部经济插件 hook 来主动调用 #fire(Player, ItemStack, double)。 当前 Bukkit/Paper 原生事件无对应概念，因此 register 方法为空。

购买物品触发器 - 外部经济插件驱动 需要外部经济插件 hook 来主动调用 #fire(Player, ItemStack, double)。 当前 Bukkit/Paper 原生事件无对应概念，因此 register 方法为空。

食用物品触发器 - 玩家吃下食物或喝下药水时触发

拾取物品触发器 - 玩家拾取物品时触发

丢弃物品触发器 - 玩家丢弃物品时触发

物品损耗触发器 - 物品耐久度减少时触发

物品损坏触发器 - 物品因耐久耗尽而损坏时触发

切换主手物品触发器 - 玩家切换主手槽位时触发

装备护甲变更触发器 - 玩家更换护甲槽位物品时触发 使用 Paper 提供的 PlayerArmorChangeEvent。

投掷鸡蛋触发器 - 玩家投掷鸡蛋时触发

投掷雪球触发器 - 玩家投掷雪球时触发

投掷末影珍珠触发器 - 玩家投掷末影珍珠时触发

使用烟花触发器 - 玩家右键使用烟花火箭时触发（手持或鞘翅推进）

装满桶触发器 - 玩家用桶装液体或牛奶时触发

倾倒桶触发器 - 玩家从桶中倾倒液体时触发

跳跃触发器 - 玩家起跳时触发

二段跳触发器 原版 Minecraft 没有二段跳事件，这里通过监听非创造/旁观模式下 玩家在空中切换飞行的行为作为二段跳近似（需要外部赋予 allowFlight=true）。

开始疾跑触发器

停止疾跑触发器

开始潜行触发器

停止潜行触发器

张开鞘翅触发器

鞘翅助推触发器 - 滑翔时使用烟花助推

鞘翅滑翔触发器 - 事件驱动维护滑翔玩家集合, 只对滑翔中的玩家按间隔触发。 检查间隔读取 config.yml 的 performance.effect-check-interval。

激流触发器 - 玩家使用激流附魔三叉戟

进入水中触发器 - 从非液体方块移动到液体方块

离开水中触发器 - 从液体方块移动到非液体方块

游泳触发器 - 玩家在水中且处于游泳姿态时触发

进入岩浆触发器

传送触发器

进入载具触发器

离开载具触发器

切换飞行状态触发器

着陆触发器 - 玩家从空中落到地面

获得药水效果触发器

失去药水效果触发器

获得经验触发器

升级触发器

增加饥饿度触发器

减少饥饿度触发器

着火触发器 - 玩家被点燃时触发

灭火触发器 原版 Minecraft 没有灭火事件，这里通过定时检查玩家 fireTicks 是否从 >0 变为 0 来近似。

冰冻触发器 - 玩家受到冰冻伤害时触发

抛竿触发器

鱼咬钩触发器

钓到鱼触发器

钓到宝藏触发器

钓到垃圾触发器

钓到实体触发器

收竿触发器

鱼钩落地触发器

被实体锁定为目标触发器

实体在附近生成触发器

与实体碰撞触发器 原版没有玩家碰撞实体事件，这里使用定时近距离检查作为近似实现。

拴绳实体触发器

解开拴绳触发器

与实体交互触发器

骑乘实体触发器

下马触发器

群系切换触发器 - 玩家从一个群系移动到另一个群系时触发

切换世界触发器 - 玩家跨世界传送时触发

闪电附近触发器 - 闪电劈下时通知 64 格内所有玩家

进入 WorldGuard 区域触发器

离开 WorldGuard 区域触发器

赢得袭击触发器 - 袭击结束时通知英雄列表中的玩家

发送聊天触发器 - 玩家在聊天框发送消息时触发 AsyncChatEvent 是异步事件，需要切回主线程执行 pipeline。

执行命令触发器 - 玩家执行命令时触发

加入服务器触发器 - 玩家加入服务器时触发

离开服务器触发器 - 玩家退出服务器时触发

完成成就触发器 - 玩家完成进度时触发

进入床铺触发器 - 玩家成功躺入床铺时触发

离开床铺触发器 - 玩家从床铺起身时触发

醒来触发器 - 玩家从床上起床时触发 本触发器与 LeaveBedTrigger 共用同一事件，仅 ID 不同。

敲响铃铛触发器 - 玩家敲响铃铛时触发

音符盒演奏触发器 - 音符盒发声时触发附近最近的玩家 NotePlayEvent 是方块事件，没有直接的触发者。这里以方块为中心， 找最近的 6 格内玩家作为触发者；找不到则不触发。

炼药锅水位变化触发器 - 玩家造成炼药锅水位变化时触发

压力板触发器 - 玩家踩到压力板时触发

绊线触发器 - 玩家踩到绊线时触发

打开容器触发器 - 玩家打开箱子/木桶/潜影盒等容器时触发

关闭容器触发器 - 玩家关闭箱子/木桶/潜影盒等容器时触发

持握触发器 - 每秒检查玩家主手物品，对手中持有物品的玩家持续触发。 使用槽位限定执行, 只处理主手物品的附魔, 不会连带触发穿着护甲上的效果。

穿戴触发器 - 每秒检查玩家 4 个护甲槽，对每件非空护甲单独触发。 使用槽位限定执行, 每件护甲只处理自己的附魔, 避免 N 件护甲触发 N² 次效果。

定时触发器(1秒) - 每 20 tick 遍历在线玩家触发一次

定时触发器(5秒) - 每 100 tick 遍历在线玩家触发一次

定时触发器(10秒) - 每 200 tick 遍历在线玩家触发一次

定时触发器(30秒) - 每 600 tick 遍历在线玩家触发一次

定时触发器(60秒) - 每 1200 tick 遍历在线玩家触发一次

自定义定时触发器 - 间隔从 config.yml 的 triggers.timer-custom-interval 读取(默认 200 tick)