songlist
在开始阅读之前
总论
歌曲信息都包含在一个叫做songlist的文件里。位置为\assets\songs
这个页面是关于更改歌曲信息的，如果想更改谱面本身，请移步谱面格式
如果想更改关于解歌条件的部分，请移步unlocks
如果想更改曲包相关内容请移步packlist
阅读总论
songlist是按照json格式编写的，有大量花括号与中括号，中间的回车与制表符除了整理版面之外没有任何意义。总之不该你改的东西你不要改就行了。
代码解析
框架
本文件总体框架如下。每一首歌曲的信息互不干扰。
{
"songs": [
{
// song 1
},
{
// song 2
} ...
]
}
细节解析
- 数据格式：
- string -- 字符串 例："brandnewworld"
- int -- 整数 例：54401
- boolean -- 布朗值 例：true（是）, false（否）
- localized字段可选属性：
- "en" -- 英文 默认语言
- "ja" -- 日文
- "ko" -- 韩文
- "zh-Hans" -- 简体中文
- "zh-Hant" -- 繁体中文
以下为歌曲信息最完整的格式。
{
"id": string (ASCII),
"title_localized": {
"en": string ...
},
"artist": string,
"artist_localized": {
"en": string ...
},
"bpm": string,
"bpm_base": int,
"set": string,
"purchase": string,
"audioPreview": int,
"audioPreviewEnd": int,
"side": int (0, 1),
"bg": string (ASCII),
"bg_daynight": {
"day": string (ASCII),
"night": string (ASCII)
},
"date": int (timestamp),
"version": string,
"world_unlock": boolean,
"remote_dl": boolean,
"byd_local_unlock": boolean,
"songlist_hidden": boolean,
"no_pp": boolean,
"source_localized": {
"en": string ...
},
"source_copyright": string,
"jacket_localized": {
"ja": boolean ...
},
"difficulties": [
{
"ratingClass": int (0, 1, 2, 3),
"chartDesigner": string,
"jacketDesigner": string,
"rating": int,
"ratingPlus": boolean,
"plusFingers": boolean,
"jacket_night": string (ASCII),
"jacketOverride": boolean,
"hidden_until_unlocked": boolean,
"bg": string (ASCII),
"world_unlock": boolean
} ...
]
}
歌曲信息
注：以下必需字段指官方songlist文件中每首歌都有的字段，删除后是否会导致游戏崩溃并未经测试。
{
"id": string (ASCII),
// 游戏程序识别歌曲的唯一ID 只能使用ASCII字符 必需字段
"title_localized": {
"en": string,
"ja": string ...
},
// 游戏内显示的曲名，可分语言设定 必需字段
"artist": string,
"artist_localized": {
"en": string ...
},// 游戏内显示的作曲者，可分语言设定。可只填artist，默认为英语 必需字段
"bpm": string,
// 游戏内显示的BPM 必需字段
"bpm_base": int,
// 基准BPM，实际游玩速度为设置的音符流速除以"bpm_base"再乘以谱面bpm 必需字段
"set": string,
// 本曲所属曲包名，参考曲包信息(packlist)格式 必需字段
"purchase": string,
// 本曲购买方式，曲包曲填所属曲包名，单曲填本曲"id"，无需购买则留空 必需字段
"audioPreview": int,
"audioPreviewEnd": int,
// 本曲预览的开始与结束时间，单位为毫秒 必需字段
"side": int (0, 1),
// 本曲属性，0为光侧，1为对立侧 必需字段
"bg": string (ASCII),
// 本曲背景名，背景jpg储存在\assets\img\bg目录中，留空即为默认背景 只能使用ASCII字符 必需字段
"bg_daynight": {
"day": string (ASCII),
"night": string (ASCII)
},// 自定义白天及夜晚显示的不同背景，参考 群愿 的技能 只能使用ASCII字符
"date": int (timestamp),
// 本曲加入时刻的10位时间戳 必需字段
"version": string,
// 本曲加入时的游戏版本，用于歌曲分类 必需字段 3.0新增
"world_unlock": boolean,
// 本曲是否需要世界模式解锁
"remote_dl": boolean,
// 本曲是否需要从服务器下载
"byd_local_unlock": boolean,
// 本曲Beyond难度是否在本地解锁。应与"world_unlock"相反 3.0新增
"songlist_hidden": boolean,
// 本曲解锁前是否歌曲界面中隐藏 3.0新增
"no_pp": boolean,
// 标记lowiro是否拥有本曲的版权。本字段对游戏没有影响
"source_localized": {
"en": string ...
},// 本曲出处，可分语言设定。歌曲界面中选择歌曲后，歌曲下方会显示 from 「"source_localized"」（其他语言）/《》（中文）
"source_copyright": string,
// 本曲版权方，仅当"source_localized"不为空时显示在 from 「」之后
"jacket_localized": {
"ja": boolean ...
},// 自定义本曲封面，可分语言设定。封面文件名为base_ja.jpg，base_ja_256.jpg（即在base后加“_语言代码”）
}
难度信息
难度谱面信息框架如下：
"difficulties": [
{
// difficulty PST
} ...
]
各难度代码结构如下：
{
"ratingClass": int (0, 1, 2, 3),
// 本段代码所定义难度。0 -- PST, 1 -- PRS, 2 -- FTR, 3 -- BYD 必需字段 3.0修改
"chartDesigner": string,
// 本难度谱师名 必需字段
"jacketDesigner": string,
// 本难度封面绘师 必需字段
"rating": int,
// 本难度等级。3.0更新前1-9对应本身，10对应9+，11对应10；3.0更新后均为本身。0均对应? 必需字段 3.0修改
"ratingPlus": boolean,
// 本难度等级是否有“+” 3.0新增
"plusFingers": boolean,
// 本难度是否有多指操作，实际并无作用
"jacket_night": string (ASCII),
// 本难度夜晚时显示的封面文件名 只能使用ASCII字符
"jacketOverride": boolean,
// 本难度是否有根据难度替换的封面。封面文件名为0.jpg，0_256.jpg（即为"ratingClass"）
"hidden_until_unlocked": boolean,
// 本难度解锁前是否歌曲界面中隐藏 3.0新增
"bg": string (ASCII),
// 自定义本难度背景名，背景jpg储存在\assets\img\bg目录中 只能使用ASCII字符
"world_unlock": boolean
// 本难度是否需要世界模式解锁，尚无法使用
}