光锥索引

本页面介绍光锥相关索引文件的结构。

索引文件

文件	索引键	用途
light_cones.json	光锥 ID	基础信息、命途、描述与资源路径
light_cone_ranks.json	光锥 ID	叠影技能与 I–V 阶数值
light_cone_promotions.json	光锥 ID	晋阶属性和消耗材料

基础信息

light_cones.json 的每项包含 id、name、rarity、path、desc、 icon、preview 和 portrait。path 可在 paths.json 中查找；所有图片字段都是相对于 StarRailRes 仓库根目录的路径。

字段说明：id 为光锥 ID；name 为本地化名称；rarity 为星级；path 为命途 ID；desc 为背景描述；icon、preview、portrait 分别为图标、预览图和立绘路径。

叠影与晋阶

light_cone_ranks.json 包含 skill、desc、params 与 properties。 params 和 properties 的五项依次对应叠影 I–V。light_cone_promotions.json 使用 values 描述各晋阶阶段的属性成长，使用 materials 描述阶段间所需材料；材料 ID 可在 items.json 中解析。

字段说明：叠影记录中的 skill 为技能名、desc 为带参数占位符的描述、params 为五个叠影等级的参数数组、properties 为对应等级的属性加成列表。晋阶记录中的 values 是阶段数组；每个属性对象的 base 是基础值、step 是每级成长值；materials 是与 values 同下标阶段的 { id, num } 材料数组。

// light_cones.json
"20000": { "id": "20000", "name": "离弦", "rarity": 3, "path": "Rogue", "desc": "...", "icon": "icon/light_cone/20000.png", "preview": "image/light_cone_preview/20000.png", "portrait": "image/light_cone_portrait/20000.png" }

// light_cone_ranks.json；params/properties 的每项对应一个叠影阶段
"20000": { "id": "20000", "skill": "危机", "desc": "... #1[i]% ...", "params": [[0.12, 3], [0.15, 3]], "properties": [[{ "type": "CriticalChanceBase", "value": 0.12 }], []] }

// light_cone_promotions.json；values/materials 相同下标对应相同晋阶阶段
"20000": { "id": "20000", "values": [{ "hp": { "base": 38.4, "step": 5.76 }, "atk": { "base": 14.4, "step": 2.16 }, "def": { "base": 12, "step": 1.8 } }], "materials": [[{ "id": "2", "num": 3000 }, { "id": "111011", "num": 4 }]] }