|
|
| 第2行： |
第2行： |
| -->{{技术型}} | | -->{{技术型}} |
| __NOINDEX__ | | __NOINDEX__ |
|
| |
| {{Usercheck}}
| |
| {{特殊页面导航}}
| |
| *'''本页保持孤立!'''
| |
|
| |
| ==在开始阅读之前==
| |
|
| |
| ===总论===
| |
|
| |
| 本文件是关于更改歌曲信息的。
| |
|
| |
| 关于谱面本身的格式，请移步[[谱面格式]]
| |
|
| |
| 关于解歌条件的部分，请移步[[解锁条件(unlocks)格式]]
| |
|
| |
| 关于曲包相关内容，请移步[[曲包信息(packlist)格式]]
| |
|
| |
| ===阅读总论===
| |
|
| |
| 本文件名为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),
| |
| // 本段代码所定义难度。0 -- PST, 1 -- PRS, 2 -- FTR, 3 -- BYD '''必需字段'''
| |
|
| |
| "chartDesigner": string,
| |
| // 本难度谱师名 '''必需字段'''
| |
|
| |
| "jacketDesigner": string,
| |
| // 本难度封面绘师 '''必需字段'''
| |
|
| |
| "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}}
| |
