歌曲信息(songlist)格式
 | 此頁面為技術型隱藏頁面 |
已確認。
- 本頁保持孤立!
在開始閱讀之前
總論
本文件是關於更改歌曲信息的。
關於譜面本身的格式，請移步譜面格式
關於解歌條件的部分，請移步解鎖條件(unlocks)格式
關於曲包相關內容，請移步曲包信息(packlist)格式
閱讀總論
本文件名為songlist，包含了除教程及愚人節外的全部歌曲相關信息。
本文件在安卓apk安裝包里的位置為 /assets/songs/songlist，在蘋果ipa安裝包內位置為 /Payload/Arc-mobile.app/songs/songlist
本文件為json文檔，有大量花括號與中括號，格式要求較為嚴格，最後一個字段後不能出現多餘的逗號。本文件用兩空格縮進整理版面。
任何對本文件的修改都會導致遊戲程序崩潰，這是因為程序中對本文件有哈希校驗。
事實上，可通過修改特定的函數，使程序在哈希校驗失敗時不調用結束進程的函數，從而達到修改songlist等文件的目的。
從這裏開始就會涉及到危險操作了,請為自己的行為負責!
代碼解析
框架
本文件總體框架如下。每一首歌曲的信息互不干擾。
{
"songs": [
{
// song 1
},
{
// song 2
} ...
]
}
細節解析
- 數據格式：
- string -- 字符串 例：
"brandnewworld" - int -- 整數 例：
54401 - boolean -- 布爾值 例：
true（是）,false（否）
- string -- 字符串 例：
- localized字段可選屬性：
- "en" -- 英文 如果其他語言的字段不存在，默認使用此字段
- "ja" -- 日文
- "ko" -- 韓文
- "zh-Hans" -- 簡體中文
- "zh-Hant" -- 繁體中文
以下為歌曲信息最完整的格式。 （歌曲信息中每一項的填寫可以亂序，沒有順序要求）
{
"idx": int,
"id": string (ASCII),
"title_localized": {
"en": string ...
},
"artist": string,
"artist_localized": {
"en": string ...
},
"bpm": string,
"bpm_base": float,
"set": string,
"purchase": string,
"category": string,
"audioPreview": int,
"audioPreviewEnd": int,
"side": int (0, 1, 2),
"bg": string (ASCII),
"bg_inverse": 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,
"no_stream": boolean,
"jacket_localized": {
"ja": boolean ...
},
"difficulties": [
{
"ratingClass": int (0, 1, 2, 3),
"chartDesigner": string,
"jacketDesigner": string,
"rating": int,
"ratingPlus": boolean,
"legacy11": boolean,
"plusFingers": boolean,
"title_localized": {
"en": string ...
},
"jacket_night": string (ASCII),
"jacketOverride": boolean,
"audioOverride": boolean,
"hidden_until_unlocked": boolean,
"bg": string (ASCII),
"world_unlock": boolean,
"date": int (timestamp),
"version": string (ASCII)
} ...
]
}
歌曲信息
註：以下必需字段指官方songlist文件中每首歌都有的字段，刪除後是否會導致遊戲崩潰並未經測試。
{
"idx": int,
// 游戏内"Link Play"功能用来判断各玩家歌曲解锁情况时用的唯一标识符 必需字段
"id": string (ASCII),
// 游戏程序识别歌曲的唯一ID 只能使用ASCII字符 必需字段
"title_localized": {
"en": string,
"ja": string ...
},// 游戏内显示的曲名，可分语言设定 必需字段
"artist": string,
"artist_localized": {
"en": string ...
},// 游戏内显示的作曲者，可分语言设定。可只填artist，默认为英语 必需字段
"bpm": string,
// 游戏内显示的BPM 必需字段
"bpm_base": float,
// 基准BPM，实际游玩速度为设置的音符流速除以"bpm_base"再乘以谱面Timing bpm 必需字段
"set": string,
// 本曲所属曲包id，参考曲包信息(packlist)格式 必需字段
"purchase": string,
// 本曲购买方式，曲包曲填所属曲包名，单曲填本曲"id"，无需购买则留空 必需字段
"category": string,
// 本曲位于单曲包 (single) 中分类，可填内容为：partner、original、variety、poprec、musicgames
"audioPreview": int,
"audioPreviewEnd": int,
// 本曲预览的开始与结束时间，单位为毫秒 必需字段
"side": int (0, 1, 2),
// 本曲属性，0为光芒侧，1为纷争侧，2为消色之侧 必需字段
"bg": string (ASCII),
// 本曲背景文件名，背景jpg储存在/assets/img/bg目录中，留空即为默认背景（base_light(光芒侧)或base_conflict(纷争侧)） 只能使用ASCII字符 必需字段
"bg_inverse": string (ASCII),
// 本曲反转背景文件名，性质同bg，是使用光 & 对立（Reunion）时更换的背景。可以删去（相对的会使其无法触发）。只能使用ASCII字符
"bg_daynight": {
"day": string (ASCII),
"night": string (ASCII)
},// 自定义白天及夜晚显示的不同背景，参考 群愿 的技能 只能使用ASCII字符
"date": int (timestamp),
// 本曲加入时刻的10位时间戳 必需字段
"version": string,
// 本曲加入时的游戏版本，用于歌曲分类，不填则在歌曲分类选定为“版本”时该歌曲独立显示
"world_unlock": boolean,
// 本曲是否需要世界模式解锁，不填默认为false
"remote_dl": boolean,
// 本曲是否需要从服务器下载，不填默认为false
"byd_local_unlock": boolean,
// 本曲Beyond难度是否在本地解锁。应与"world_unlock"相反
"songlist_hidden": boolean,
// 本曲解锁前是否在歌曲界面中隐藏，不填默认为false
"no_pp": boolean,
// 标记lowiro是否拥有本曲的版权。本字段对游戏没有影响
"source_localized": {
"en": string ...
},// 本曲出处，可分语言设定。歌曲界面中选择歌曲后，歌曲下方会显示 from 「"source_localized"」（其他语言）/来自 《》（中文）
"source_copyright": string,
// 本曲版权方，仅当"source_localized"不为空时显示在 from 「」之后（以"source_copyright"显示（注意版权标©也在source_copyright的值中））
"no_stream": boolean,
// 本曲是否能够在直播模式中游玩（目前出现此标识的值均为true）
"jacket_localized": {
"ja": boolean ...
},// 自定义本曲封面，可分语言设定。封面文件名为base_ja.jpg，base_ja_256.jpg（即在base后加“_语言代码”）
}
難度信息
難度譜面信息框架如下：
"difficulties": [
{
// difficulty PST
} ...
]
各難度代碼結構如下：
{
"ratingClass": int (0, 1, 2, 3, 4),
// 本段代码所定义难度。0 -- PST, 1 -- PRS, 2 -- FTR, 3 -- BYD, 4 -- ETR 必需字段
"chartDesigner": string,
// 本难度谱师名 必需字段
"jacketDesigner": string,
// 本难度封面绘师 必需字段
"rating": int,
// 本难度等级。3.0更新前1-9对应本身，10对应9+，11对应10；3.0更新后均对应本身。0均对应“?” 必需字段[1]
"legacy11": boolean,
// 表示该谱面在计算回忆系数时是否将回忆系数 * 0.8, 默认为 false 6.0新增
"ratingPlus": boolean,
// 本难度等级是否有“+”，不填默认为false 3.0新增
"plusFingers": boolean,
// 本难度是否有多指操作，实际并无作用[2][3]
"title_localized": {
"en": string,
"ja": string ...
},// 本难度显示的曲名，可分语言设定
"artist": string,
// 本难度显示的作曲者
"bpm": string,
// 本难度显示的BPM
"bpm_base": float,
// 本难度的基准BPM
"jacket_night": string (ASCII),
// 本难度夜晚时显示的封面文件名 只能使用ASCII字符
"jacketOverride": boolean,
// 本难度是否有根据难度替换的封面。封面文件名为0.jpg，0_256.jpg（即为"ratingClass"），不填默认为false
"audioOverride": boolean,
// 本难度是否有根据难度替换的音频文件。音频文件名为3.ogg（即为"ratingClass"），不填默认为false
"hidden_until_unlocked": boolean,
// 本难度解锁前是否歌曲界面中隐藏，不填默认为false
"bg": string (ASCII),
// 本难度的背景，对于安卓apk，背景jpg储存在/assets/img/bg目录中；对于苹果ipa，背景jpg储存在/Payload/Arc-mobile.app/img/bg中 只能使用ASCII字符
"bg_inverse": string (ASCII),
// 本难度使用的反转背景，性质同bg，是使用光 & 对立（Reunion）时更换的背景
"world_unlock": boolean,
// 本难度是否需要世界模式解锁，不填默认为false
"date": int (timestamp),
// 本难度加入时刻的10位时间戳（即单位为秒的UNIX时间戳）
"version": string
// 本曲加入时的游戏版本，用于歌曲分类
}
- ↑ 6.0後決定回憶係數是否 * 0.8不再依賴於此項
- ↑ 官方songlist中最後含有本參數的譜面是Ether Strike FTR、Fracture Ray PRS&FTR、Grievous Lady PRS&FTR、DataErr0r FTR；World Vanquisher及以後一些譜面也出現了多押但沒有使用本參數
- ↑ 該字段在早期版本為 int 類型且為必須字段