Theseus 模组文档
API 参考 / spi 包:游戏模式、谱面扩展与内容

ComboBehavior


想先跑起来?

这一页是签名与行为参考。这一档判定对连击做什么。直接做一遍:教程 · 添加判定等级。

判定等级对连击(combo)的影响行为枚举,由 JudgmentKindDefinition.comboBehavior() 返回。宿主直接 switch 该枚举,因此实现不得返回 null。

常量

常量含义
INCREMENTcombo 递增(如 PERFECT、GREAT)
RESETcombo 归零(如 MISS)
NONEcombo 不变(特殊判定,如未判定 NONE)

方法速览

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

values()

签名:

java
public static ComboBehavior[] values();

行为:返回 {INCREMENT, RESET, NONE},每次调用返回新数组。

valueOf(String name)

签名:

java
public static ComboBehavior valueOf(String name);

行为:按名称精确匹配(区分大小写);null 或未知名称抛 IllegalArgumentException。

示例

java
ComboBehavior behavior = ComboBehavior.RESET;

完整签名

java
public enum ComboBehavior {
    INCREMENT,
    RESET,
    NONE
}

线程:源码未声明额外线程约束;枚举常量不可变,可跨线程读取。

生命周期阶段:运行期读取。

稳定性:2.0 起冻结:2.x 内只增不破(禁止删签名/改签名/改语义)。