API 参考 / 事件系统

ChartLoadEvent

谱面解析完成、进入可游玩状态时投递。宿主在同一帧先投递本事件，随后投递 GameStartEvent；预览模式重载谱面时也会再投递。

方法速览

方法	用途
`context()`	谱面已就绪的游玩状态只读快照

context()

java

public GameplayContext context();

行为：返回谱面已就绪时的状态快照。适合在此预先准备与本谱面相关的显示数据（例如缓存 totalNoteCount()、chartDurationMs()、曲绘等），避免在每帧事件里重复计算。

示例：

java

ctx.eventBus().subscribe(ChartLoadEvent.class, event -> {
    totalNotes = event.context().totalNoteCount();
    chartDurationMs = event.context().chartDurationMs();
});

完整签名

java

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

行为核验：宿主必须继续进入游玩，不可取消。

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

上一页GameEndEvent 下一页GameplayTickEvent