「歌曲信息(songlist)格式」:修訂間差異
無編輯摘要 |
(→难度信息: ratingClass增加ETR) |
||
(未顯示由 20 位使用者於中間所作的 38 次修訂) | |||
行 1: | 行 1: | ||
{{技术型}} | <!--如果你通过查看源代码发现了这里,那么恭喜你发现了查看内容的第二种方法。 | ||
-->{{技术型}} | |||
__NOINDEX__ | |||
{{Usercheck}} | |||
{{特殊页面导航}} | |||
*'''本页保持孤立!''' | *'''本页保持孤立!''' | ||
==在开始阅读之前== | ==在开始阅读之前== | ||
===总论=== | ===总论=== | ||
本 文件是关于更改歌曲信息的 。 | |||
关于 谱面本身 的格式, 请移步[[谱面格式]] | |||
关于解歌条件的部分 , 请移步[[解锁条件(unlocks)格式]] | |||
关于 曲包相关内容 , 请移步[[曲包信息(packlist)格式]] | |||
===阅读总论=== | ===阅读总论=== | ||
songlist | |||
本文件名为songlist,包含了除教程及愚人节外的全部歌曲相关信息。 | |||
本文件在安卓apk安装包里的位置为 /assets/songs/songlist,在苹果ipa安装包内位置为 /Payload/Arc-mobile.app/songs/songlist | |||
本文件为json文档, 有大量花括号与中括号 ,格式要求较为严格,最后一个字段后不能出现多余 的 逗号。本文件用两空格缩进 整理版面 。 | |||
''' 任何 对本文件的修改都会导致游戏程序崩溃,这是因为程序中对本文件有哈希校验。''' | |||
'' 事实上,可通过修 改 特定 的 函数,使程序在哈希校验失败时 不 调用结束进程的函数,从而达到修改songlist等文件的目的。'' | |||
'''从这里开始 就 会涉及到危险操作了,请为自己的 行 为负责!''' | |||
<!-- 事实上,游戏程序中所判断的校验值是将文件的MD5复制一份(即"MD5MD5")然后将该字符串再次求MD5校验值得到的。 | |||
例如,对于Arcaea 3.5.3c版本,songlist文件的MD5校验码是a9e8ddcaaf2daa73fc0ba91cfb371f70 | |||
则复制一份并拼到原始MD5后面,得到"a9e8ddcaaf2daa73fc0ba91cfb371f70a9e8ddcaaf2daa73fc0ba91cfb371f70" | |||
对该字符串求MD5校验值,可得到"942951c9a95cc3a3694c8c8c27f5293a" | |||
而942951c9a95cc3a3694c8c8c27f5293a正是游戏程序中所使用的校验值 | |||
因此直接修改游戏程序中为songlist文件修改后所得到的校验值也可以,但比较麻烦(每次修改songlist都需要改一次程序) | |||
--> | |||
==代码解析== | ==代码解析== | ||
===框架=== | ===框架=== | ||
本文件总体框架如下。每一首 歌曲 的 信 息互不干扰。 | |||
<syntaxhighlight lang="json"> | |||
{ | |||
"songs": [ | |||
{ | |||
// song 1 | |||
}, | |||
{ | |||
// song 2 | |||
} ... | |||
] | |||
} | |||
</syntaxhighlight> | |||
===细节解析=== | ===细节解析=== | ||
*数据格式: | |||
**string -- 字符串 例:<code>"brandnewworld"</code> | |||
**int -- 整数 例:<code>54401</code> | |||
**boolean -- 布尔值 例:<code>true</code>(是), <code>false</code>(否) | |||
*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, | |||
"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, | |||
"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",无需购买则留空 '''必需字段''' | |||
"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, | |||
// 本难度谱师名 '''必需字段''' | |||
"chartDesigner": | |||
"jacketDesigner": | "jacketDesigner": string, | ||
"rating": | // 本难度封面绘师 '''必需字段''' | ||
"rating": int, | |||
// 本难度等级。3.0更新前1-9对应本身,10对应9+,11对应10;3.0更新后均对应本身。0均对应“?” '''必需字段''' | |||
"ratingPlus": boolean, | |||
// 本难度等级是否有“+”,不填默认为false ''3.0新增'' | |||
"plusFingers": boolean, | |||
// 本难度是否 有多指操作 , 实际并无作用<ref> 官方songlist中最后含有本参数的谱面是[[Ether Strike]] FTR、[[Fracture Ray]] PRS&FTR、[[Grievous Lady]] PRS&FTR、[[DataErr0r]] FTR;[[World Vanquisher]]及以后 一 些谱面也出现了多押但没有使用本参数</ref> | |||
"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 | |||
// 本曲加入时 的 游戏版本,用于歌曲分类 | |||
} | |||
{{reflist}} | |||
{{Usercheck-end}} |
於 2024年4月27日 (六) 08:09 的最新修訂
![]() | 此頁面本頁面為技術型隱藏頁面 |
已確認。
- 本頁保持孤立!
在開始閱讀之前
總論
本文件是關於更改歌曲信息的。
關於譜面本身的格式,請移步譜面格式
關於解歌條件的部分,請移步解鎖條件(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, "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, "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",无需购买则留空 必需字段 "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均对应“?” 必需字段 "ratingPlus": boolean, // 本难度等级是否有“+”,不填默认为false 3.0新增
"plusFingers": boolean, // 本难度是否有多指操作,实际并无作用[1] "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 // 本曲加入时的游戏版本,用于歌曲分类 }
- ↑ 官方songlist中最後含有本參數的譜面是Ether Strike FTR、Fracture Ray PRS&FTR、Grievous Lady PRS&FTR、DataErr0r FTR;World Vanquisher及以後一些譜面也出現了多押但沒有使用本參數