⚡能力触发器
最后更新于
触发器是附魔 powers 下的一个配置部分,用于决定能力何时执行,并创建供能力条件、能力修改器和能力使用的上下文。
powers:
on-attack:
conditions: {}
modifiers: {}
abilities: {}EnchantmentReform 目前注册了 61 个内置触发器。
每个触发器都会创建一个 TriggerData 上下文。各角色的实际含义取决于所使用的触发器。
PLAYER
提供当前激活附魔物品的玩家。此上下文始终存在。
SOURCE
对事件负责的行为主体或所有者。
SKILL
直接载体或中间实体,例如投射物、鱼钩、烟花或监守者。
TARGET
最终受到影响或被检查的实体。
BLOCK
触发器提供的事件方块。
LOCATION
供位置相关条件和能力使用的主要事件位置。
FROM / TO
触发器提供的移动起点和终点。
TRIGGER_ITEM / TRIGGER_SLOT
选中当前激活附魔的物品和槽位。
EVENT
底层 Bukkit/Paper 事件。
TICK
周期性触发器使用的运行时 Tick。
SOURCE、SKILL、TARGET、BLOCK、移动位置和触发物品数据均为可选上下文。需要某个缺失上下文的条件或能力会安全失败或被跳过。
不要假设同一个选择器在所有触发器中都具有相同含义。例如,on-attack 使用 SOURCE 表示发起攻击的玩家,使用 SKILL 表示直接造成伤害的投射物或伤害来源;而 on-damage 使用 TARGET 表示正在受到伤害的附魔玩家。
应先选择触发器,再打开对应的分类页面确认它提供哪些上下文。
例如:
damage 修改器需要触发器提供可修改的伤害数据;
item_damage 需要使用 on-item-damage;
钓鱼结果修改器需要使用 on-fish,并处于对应的钓鱼状态;
交易修改器需要使用 on-purchase 或 on-trade;
warden_anger 需要使用 on-warden-anger-change;
方块条件需要触发器提供 BLOCK;
以实体为目标的能力必须使用该触发器实际提供的选择器。
其他插件可以通过 EnchantmentReform API 注册自定义触发器。自定义触发器的键及其上下文由扩展插件定义,因此不会列入本页面的内置触发器清单。
最后更新于