2023/5/13大约 5 分钟资源
本页面介绍角色相关索引文件的结构。
角色索引文件
在对应语言文件夹（index_new/[lang] index_min/[lang]）下有以下几个和角色相关的索引文件：
characters.json # 角色基本信息，索引为角色id
character_ranks.json # 角色星魂，索引为星魂id
character_skills.json # 角色技能，索引为技能id
character_skill_trees.json # 角色行迹，索引为行迹id
character_promotions.json # 角色晋阶，索引为角色id角色基本信息
以下是 characters.json 每一项各个字段的含义：
"1001": {
// 角色id
"id": "1001",
// 角色名
"name": "三月七",
// 角色标签
"tag": "mar7th",
// 稀有度
"rarity": 4,
// 命途id 在 `paths.json` 中查询
"path": "Knight",
// 属性id 在 `elements.json` 中查询
"element": "Ice",
// 能量上限（施放一次终结技所需能量）
"max_sp": 120.0,
// 星魂id列表 在 `character_ranks.json` 中查询
// 当前满足规则 角色id + 0 + 星魂序号（1-6）
// 长度为 6 分别表示第 1-6 个星魂
"ranks": ["100101", "100102", "100103", "100104", "100105", "100106"],
// 技能id列表 在 `character_skills.json` 中查询
// 当前满足规则 角色id + 0 + [123467]
// 长度为 6-8
// 分别表示 普攻 技能 终结技 天赋 攻击 秘技
// 长度大于 6 时 xxxx08 和 xxxx09 表示部分技能的可选效果 如单攻/扩散
"skills": ["100101", "100102", "100103", "100104", "100106", "100107"],
// 行迹id列表 在 `character_skill_trees.json` 中查询
// 当前满足规则 角色id + 三位行迹序号
// 长度为 18
"skill_trees": ["1001001", "1001002", "1001003", "1001004", "1001007", "1001101", "1001102", "1001103", "1001201", "1001202", "1001203", "1001204", "1001205", "1001206", "1001207", "1001208", "1001209", "1001210"],
// 角色icon图片路径
"icon": "icon/character/1001.png",
// 角色预览图片路径
"preview": "image/character_preview/1001.png",
// 角色立绘图片路径
"portrait": "image/character_portrait/1001.png"
}以下是 character_ranks.json 每一项各个字段的含义：
"110203": {
// 星魂id 角色id + 0 + 星魂序号（1-6）
"id": "110203",
// 星魂序号
"rank": 3,
// 星魂名称
"name": "千星的萤光",
"desc": "",
// 解锁材料列表 在 `items.json` 中查询
// 此处长度为1 固定为角色的星魂 数量为1
"materials": [
{ "id": "11102", "num": 1 }
],
// 升级技能列表 在 `character_skills.json` 中查询
"level_up_skills": [
{ "id": "110202", "num": 2 },
{ "id": "110204", "num": 2 }
],
// 星魂icon图片路径
"icon": "icon/skill/1102_skill.png"
}以下是 character_skills.json 每一项各个字段的含义：
"100603": {
// 技能id 角色id + 0 + [123467]
"id": "100603",
// 技能名称
"name": "|账号已封禁|",
// 技能最大等级
"max_level": 15,
// 元素类型id 在 `elements.json` 中查询
"element": "Quantum",
// 技能类型
"type": "Ultra",
// 技能类型描述
"type_text": "终结技",
// 技能效果类型
"effect": "Impair",
// 技能效果类型描述
"effect_text": "妨害",
// 技能简单描述
"simple_desc": "对敌方单体造成大量量子属性伤害，大概率施加防御降低效果。",
// 技能详细描述
// 包含参数占位符 #{index}[{format}]{percent?}
// #1[i] 表示第一个参数取整 例如 2.1 -> 2
// #2[i]% 表示第二个参数取0位小数百分比表示 例如 0.85 -> 85%
// #3[f1] 表示第三个参数取1位小数 例如 0.4 -> 0.4
// #4[f2]% 表示第四个参数取2位小数百分比表示 例如 0.0625 -> 6.25%
"desc": "有#2[i]%的基础概率使受到攻击的敌方目标防御力降低#3[i]%，持续#4[i]回合，同时对指定敌方单体造成等同于银狼#1[i]%攻击力的量子属性伤害。",
// 技能详细描述参数列表
// 长度等于 max_level
// level 1 对应数组下标 0
"params": [
[ 2.1, 0.85, 0.4, 3.0 ],
[ 2.24, 0.865, 0.41, 3.0 ]
// 以下省略 13 项
],
"icon": "icon/skill/1006_ultimate.png"
}以下是 character_skill_trees.json 每一项各个字段的含义：
"1104205": {
// 行迹id 角色id + 3 位行迹序号
"id": "1104205",
// 行迹最大等级
"max_level": 1,
// 行迹名称与描述；描述可包含 #1[i] 等参数占位符
"name": "冰棘",
"desc": "施放终结技时，有#1[i]%的基础概率使敌方目标冻结。",
// 每个等级对应一组描述参数
"params": [[0.5]],
"anchor": "Point13",
// 行迹前置 行迹id 列表
"pre_points": [
"1104102"
],
// 行迹提升技能等级列表
"level_up_skills": [],
// 行迹等级详细信息列表
// 长度等于 max_level
"levels": [
{
// 要求的晋阶等级
"promotion": 4,
// 此等级对应的角色等级限制
"level": 0,
// 属性提升列表 在 `properties.json` 中查询
"properties": [
{ "type": "IceAddedRatio", "value": 0.048 }
],
// 消耗材料列表 在 `items.json` 中查询
"materials": [
{ "id": "2", "num": 20000 },
{ "id": "110142", "num": 5 },
{ "id": "112002", "num": 4 }
]
}
],
// 行迹或属性节点图标路径
"icon": "icon/skill/1104_skill.png"
}角色晋阶
character_promotions.json 以角色 ID 为索引。values 和 materials 数组下标均对应同一个晋阶阶段；属性值为 base + step × 等级成长次数，材料 ID 在 items.json 中查询。
"1001": {
"id": "1001",
"values": [
{
"hp": { "base": 144, "step": 7.2 },
"atk": { "base": 69.6, "step": 3.48 },
"def": { "base": 78, "step": 3.9 },
"spd": { "base": 101, "step": 0 },
"taunt": { "base": 150, "step": 0 },
"crit_rate": { "base": 0.05, "step": 0 },
"crit_dmg": { "base": 0.5, "step": 0 }
}
],
"materials": [[{ "id": "2", "num": 4000 }, { "id": "110141", "num": 2 }]]
}参考数据结构
以下是使用 Python 解析索引文件的参考数据结构。
class CharacterType():
id: str
name: str
tag: str
rarity: int
path: str
element: str
max_sp: float
ranks: List[str]
skills: List[str]
skill_trees: List[str]
icon: str
preview: str
portrait: str
class CharacterRankType():
id: str
name: str
rank: int
desc: str
materials: List[Quantity]
level_up_skills: List[Quantity]
icon: str
class CharacterSkillType():
id: str
name: str
max_level: int
element: str
type: str
type_text: str
effect: str
effect_text: str
simple_desc: str
desc: str
params: List[List[float]]
icon: str
class SkillTreeLevelType():
promotion: int
level: int
properties: List[Property]
materials: List[Quantity]
class CharacterSkillTreeType():
id: str
name: str
max_level: int
desc: str
params: List[List[float]]
anchor: str
pre_points: List[str]
level_up_skills: List[Quantity]
levels: List[SkillTreeLevelType]
icon: str
class CharacterPromotionType():
id: str
values: List[Dict[str, Promotion]]
materials: List[List[Quantity]]
# characters.json
CharacterIndex = Dict[str, CharacterType]
# character_ranks.json
CharacterRankIndex = Dict[str, CharacterRankType]
# character_skills.json
CharacterSkillIndex = Dict[str, CharacterSkillType]
# character_skill_trees.json
CharacterSkillTreeIndex = Dict[str, CharacterSkillTreeType]
# character_promotions.json
CharacterPromotionIndex = Dict[str, CharacterPromotionType]