Common Data Index

This page covers shared dictionaries used by the character, Light Cone and relic indexes.

File	Key	Main fields
paths.json	Path ID	name, text, desc, three icon paths
elements.json	Element ID	name, desc, color, icon
properties.json	Property type	name, field, percent, order, icon
items.json	Item ID	name, type, sub_type, rarity, icon, come_from
avatars.json	Avatar ID	name, icon
achievements.json	Achievement ID	series_id, title, desc, hide_desc, hide
descriptions.json	Description ID	title, desc
nickname.json	Dataset name	ID-to-alias mappings for search

Use these files to resolve IDs in the domain-specific indexes. Asset paths are relative to the StarRailRes repository root. nickname.json contains separate maps for characters, light_cones and relics; each map value is an array of searchable aliases.

Field notes: Paths use id, text, name, desc and three icon* paths; elements add display color. Property definitions use field, boolean affix/ratio/percent flags and display order. Items use category type/sub_type and source list come_from. Achievements use series_id, visible desc, optional hide_desc and boolean hide. Avatar, description and nickname records are shown in full below.

Record shapes

// paths.json / elements.json
{"Warrior":{"id":"Warrior","text":"Destruction","name":"Destruction","desc":"...","icon":"icon/path/Destruction.png","icon_middle":"icon/path/DestructionMiddle.png","icon_small":"icon/path/DestructionSmall.png"}}
{"Ice":{"id":"Ice","name":"Ice","desc":"...","color":"#47C7FD","icon":"icon/element/Ice.png"}}

// properties.json / items.json
{"MaxHP":{"type":"MaxHP","name":"HP","field":"","affix":false,"ratio":false,"percent":false,"order":1,"icon":"icon/property/IconMaxHP.png"}}
{"1":{"id":"1","name":"Stellar Jade","type":"Virtual","sub_type":"Virtual","rarity":5,"icon":"icon/item/900001.png","come_from":[]}}

// avatars.json / achievements.json / descriptions.json
{"1":{"id":"1","name":"Wen Mingde","icon":"icon/avatar/UI_Message_Contacts_Wenmingde.png"}}
{"4010101":{"id":"4010101","series_id":"1","title":"Ever-Burning Amber","desc":"...","hide_desc":"","hide":true}}
{"10001":{"id":"10001","title":"Paths","desc":"..."}}

// nickname.json: top-level keys are datasets, then IDs map to alias arrays
{"characters":{"1001":["March 7th"]},"light_cones":{"20000":["Arrows"]},"relics":{"31011":["Passerby's Rejuvenated Wooden Hairstick"]}}