For the complete documentation index, see llms.txt. This page is also available as Markdown.

能力触发器

触发器是附魔 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。

SOURCESKILLTARGETBLOCK、移动位置和触发物品数据均为可选上下文。需要某个缺失上下文的条件或能力会安全失败或被跳过。

不要假设同一个选择器在所有触发器中都具有相同含义。例如,on-attack 使用 SOURCE 表示发起攻击的玩家,使用 SKILL 表示直接造成伤害的投射物或伤害来源;而 on-damage 使用 TARGET 表示正在受到伤害的附魔玩家。

触发器列表

Tick 与生命周期触发器

战斗、伤害与死亡触发器

投射物与远程触发器

方块与交互触发器

物品、附魔与装备触发器

移动与输入触发器

效果、空气、食物与经验触发器

钓鱼与交易触发器

目标选择与特殊实体触发器

选择兼容的条件和修改器

应先选择触发器,再打开对应的分类页面确认它提供哪些上下文。

例如:

  • damage 修改器需要触发器提供可修改的伤害数据;

  • item_damage 需要使用 on-item-damage

  • 钓鱼结果修改器需要使用 on-fish,并处于对应的钓鱼状态;

  • 交易修改器需要使用 on-purchaseon-trade

  • warden_anger 需要使用 on-warden-anger-change

  • 方块条件需要触发器提供 BLOCK

  • 以实体为目标的能力必须使用该触发器实际提供的选择器。

扩展触发器

其他插件可以通过 EnchantmentReform API 注册自定义触发器。自定义触发器的键及其上下文由扩展插件定义,因此不会列入本页面的内置触发器清单。

最后更新于