Theseus 模组文档
API 参考 / 事件系统

EventPriority


想先跑起来?

这一页是签名与行为参考。先收谁的后收谁的。直接做一遍:教程 · 订阅游玩事件。

监听器优先级。枚举声明顺序即执行顺序:HIGHEST 最先收到事件,LOWEST 最后;同一优先级内按注册顺序(稳定序)。

常量

常量相对次序用途
HIGHEST最先收到抢先否决或强行放行
HIGH较早收到压过默认优先级意见的干预
NORMAL默认单参数 subscribe 走此级
LOW较晚收到常规观察
LOWEST最后收到纯观察 / 记录(可看到其它监听器处理后的最终状态)

方法速览

方法用途
values()按声明顺序返回全部常量
valueOf(String)按名称取常量

values()

java
public static EventPriority[] values();

行为:返回 {HIGHEST, HIGH, NORMAL, LOW, LOWEST},每次调用返回新数组。

valueOf(String name)

java
public static EventPriority valueOf(String name);

行为:按名称精确匹配;null 或未知名称抛 IllegalArgumentException。

示例

java
ctx.eventBus().subscribe(NoteJudgedEvent.class, EventPriority.LOW, event -> {
    // 观察型:等干预型监听器先表态
});

完整签名

java
public enum EventPriority {
    HIGHEST,
    HIGH,
    NORMAL,
    LOW,
    LOWEST
}

稳定性:2.0 起冻结,2.x 内只增不破。