Theseus 模组文档
API 参考 / 能力接口(capability 包)

TrackStyleQuery


轨道样式查询参数,由宿主在 TrackStyleProvider.styleFor 调用时构造,每帧构造,勿长期持有。

方法速览

方法用途
trackId()轨道标识
isFake()是否假轨道
index()真轨 lane 序号 / 假轨 id

完整签名

java
public interface UiCustomization {

    interface TrackStyleQuery {

        String trackId();

        boolean isFake();

        int index();
    }
}

trackId()

签名:

java
String trackId();

行为:轨道标识。真轨道为 "lane_0" .. "lane_{n-1}";假轨道为 "fake_{id}"(id 为 fake_track_create 配置的假轨道 id)。画布原点模式的假轨道(originLane = -1)同样可被覆盖,可用 keyText 替换默认的 "?" 占位。

示例:

java
if ("lane_0".equals(query.trackId())) { /* 第一条真轨 */ }

isFake()

签名:

java
boolean isFake();

行为:true 表示假轨道(装饰 / 特殊轨道),false 表示参与判定的真轨道。

示例:

java
if (query.isFake()) {
    return null;             // 假轨道保持默认
}

index()

签名:

java
int index();

行为:真轨道返回 lane 序号(0-based,与 "lane_N" 的 N 一致);假轨道返回假轨道 id(整数)。不要用它推断真假——配合 isFake() 使用。

示例:

java
int lane = query.index();
boolean first = !query.isFake() && lane == 0;

线程:游戏渲染线程。

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