API 参考 / 打击特效样式（render 包）

HitEffectContext

想先跑起来？

这一页是签名与行为参考。回答里能拿到的判定等级、轨道与强度。直接做一遍：教程 · 自定义打击特效。

用途：打击特效的触发上下文，由宿主在音符被判定时构造并传入 HitEffectStyleProvider#getStyle。

完整签名

java

public interface HitEffectContext {

    JudgmentKindDefinition grade();

    HitEffectNoteType noteType();

    int lane();
}

grade()

签名：

java

JudgmentKindDefinition grade();

行为：返回本次判定的等级定义。判定等级的身份由注册表键承载（RegistryKey），接口本身不带 id 字段；做分支时读 displayName()（如 "PERFECT" / "GREAT"）、scoreValue()、accuracyWeight() 或 color()。模组自定义并注册的判定等级同样会出现在这里。

noteType()

签名：

java

HitEffectNoteType noteType();

行为：返回触发特效的音符类型（Tap / Hold 头 / Hold 脉冲 / Hold 尾 / Barrier / Exploit / Payload），用于对不同类型给不同特效。

lane()

签名：

java

int lane();

行为：返回轨道索引。注意特效位置由宿主按该轨道自动锚定（轨道中心 + 判定线），模组不需要自己算坐标。

上一页HitEffectStyleProvider 下一页HitEffectNoteType