API 参考 / 事件系统

ComboBreakEvent

想先跑起来？

这一页是签名与行为参考。连击中断时触发，适合做提示与音效。直接做一遍：教程 · 订阅游玩事件。

连击被打断时投递（本次 MISS 导致 combo 归零），且投递时打断已经发生。

方法速览

方法	用途
`context()`	中断后的游玩状态只读快照

java

public GameplayContext context();

行为：返回中断后的状态快照（combo() 已为 0）。用于播放反馈或记录；不要试图回滚连击。

示例：

java

ctx.eventBus().subscribe(ComboBreakEvent.class, event -> {
    brokenAtCombo = lastKnownCombo;
});

java

public class ComboBreakEvent extends Event {
    public ComboBreakEvent(GameplayContext context);
    public GameplayContext context();
}

行为核验：连击已归零，「吞掉中断」需要回滚计分状态，不属于可执行的默认动作，因此不可取消。想避免该次 MISS，请用判定等级 / 判定调整器从源头处理。

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