Theseus 模组文档
API 参考 / 渲染、资源与语言

RenderLayer


用途:引擎内置渲染层枚举,自底向上 7 层,编号越大越靠上。宿主在每层前后各投递一次 RenderEvent.Pre / .Post,7 层全部可插。

完整签名

java
public enum RenderLayer {
    BACKGROUND(0),
    WORLD(1),
    NOTES(2),
    JUDGE_FX(3),
    HUD(4),
    OVERLAY(5),
    FULLSCREEN(6);

    public int index();
}

index()

签名:

java
public int index();

行为:返回该层的固定编号 0-6,可用于排序或比较(layer.index() < RenderLayer.HUD.index())。

各层内容

层编号默认内容
BACKGROUND0背景:模组背景渲染器(曲绘/纯色等),位于游玩内容之下
WORLD1轨道容器:模组轨道样式、Z 分层轨道、HOLD 长条装饰
NOTES2轨道与音符:真实/假轨道与音符、屏障指示
JUDGE_FX3判定特效:打击特效(含模组 HitEffectStyle)
HUD4原版 HUD:combo、进度条、分数/准度/血条、模组 HUD 覆盖
OVERLAY5覆盖层:altHud、暂停对话框、renderOverlay、入场黑幕
FULLSCREEN6全屏后处理:模组滤镜(RenderFilter)

层内叠放用开放整数层号(见 RenderFilter#zOrder() / BackgroundRenderer#zOrder()):数字越大越靠上,可为负数或大数字,不受 0-6 限制。