歌曲信息(songlist)格式

来自Arcaea中文维基
Benpigchu讨论 | 贡献2020年7月16日 (四) 20:59的版本 (避免搜索引擎收录技术型页面)


  • 本页保持孤立!

在开始阅读之前

总论

歌曲信息都包含在一个叫做songlist的文件里。在安卓apk安装包里的位置为 \assets\songs\songlist.

这个文件是关于更改歌曲信息的,如果想更改谱面本身,请移步谱面格式

如果想更改关于解歌条件的部分,请移步解锁条件(unlocks)格式

如果想更改曲包相关内容请移步曲包信息(packlist)格式

阅读总论

songlist使用json格式,有大量花括号与中括号,格式要求较为严格。中间的回车与制表符除了整理版面之外没有任何意义。

任何对本文件的修改都会游戏程序崩溃,这是因为程序中对这几个信息文件做了哈希校验。

代码解析

框架

歌曲信息在文件里总体排列成这样

{
  "songs": [
    {
      歌曲信息1
    },
    {
      歌曲信息2
    },……,
    {
      歌曲信息n
    }
  ]
}

可见歌曲信息之间的互不干扰性。

细节解析

 {
     "id": "id",
     "title_localized": {
       "en": "title"
       "ja": "日本語の表記"
     },
     "artist": "artist",
     "bpm": "BPM",
     "bpm_base": BPM_Base,
     "set": "setpack",
     "purchase": "purchasemethod",
     "audioPreview": Preview1,
     "audioPreviewEnd": Preview2,
     "side": side,
     "world_unlock": worldBoolean,
     "no_pp": ppBoolean,
     "bg": "setBG",
     "date": time,
     "remote_dl": remoteDLBoolean,
     "byd_local_unlock": bydBoolean,
     "version": version,
     "songlist_hidden": hiddenBoolean,
     "source_localized": {
       "en": "source"
     },
     "source_copyright": "©copyright",
     "difficulties": [
       {
         "ratingClass": 0(ratingClass),
         "chartDesigner": "chartDesigner",
         "jacketDesigner": "illustrator",
         "rating": rating,
         "plusFingers": plusFingersBoolean,
       },
       {
         "ratingClass": 1(ratingClass),
         "chartDesigner": "chartDesigner",
         "jacketDesigner": "illustrator",
         "rating": rating,
         "plusFingers": plusFingersBoolean,
       },
       {
         "ratingClass": 2(ratingClass),
         "chartDesigner": "chartDesigner",
         "jacketDesigner": "illustrator",
         "rating": rating,
         "plusFingers": plusFingersBoolean,
       }
     ]
   }


文件头

 {
     "id": "id",
     "title_localized": {
       "en": "title"
       "ja": "日本語の表記"
     },
     "artist": "artist",
     "bpm": "BPM",
     "bpm_base": BPM_Base,
     "set": "setpack",
     "purchase": "purchasemethod",
     "audioPreview": Preview1,
     "audioPreviewEnd": Preview2,
     "side": side,
     "world_unlock": worldBoolean,
     "no_pp": ppBoolean,
     "bg": "setBG",
     "date": time,
     "byd_local_unlock": bydBoolean,
     "version": version,
     "songlist_hidden": hiddenBoolean,
     "remote_dl": remoteDLBoolean,
     "source_localized": {
       "en": "source"
     },
     "source_copyright": "©copyright",
     "difficulties": [……
       ]
   }
  • id(ansistring):歌曲ID名,至关重要,像解锁条件等引用歌曲的时候是引用id的,并且对应谱面文件夹也必须是id名,如果是远程下载的曲子,在preview文件夹里放预览音频时,文件名也必须和id一样,不能出现非ASCII字符
  • title_localized(ansistring):长这样
 "title_localized": {
       "en": "title",
       "ja": "タイトル"
     },
  • 其中title是你要填的曲名,"en"是英文,"ja"是日文,"ko"是韩文(从来没出现),"zh-Hans"为简中,"zh-Hant"为繁中,默认语言为英文,可以填任何字符,当出现多个语言时用逗号隔开.
    • jacket_localized类似,不过是关于封面
  • artist(ansistring):曲作者名,没有语言区别,可以填任何字符.
  • BPM(ansistring):向玩家显示本曲的BPM,可以填任何字符,这意味着我填"0-∞"是可以的了.
  • BPM_Base:这个要注意一下,它表示Hi-Speed最大时用于计算的BPM,与谱面BPM毫无关联.游玩时,谱面的Hi-Speed不会大于该数值*你的Hi-Speed设置倍数.(AC出现了99999.00的BPM但Base依然170)真正的Hi-Speed依然由谱面内的Timing语句决定.
    • 当你的谱面有瞬间出现这样的设计时,建议将该数值写成三个谱面文件里出现的最普遍的BPM,不过当基准BPM≥180时请想想这样做谱面猎奇的可能性.
      • 以及这个数值就不要傻到填0或负数了,读也许能读,但……
  • setpack(ansistring):该曲目所隶属的曲包,请移步曲包信息(packlist)格式
  • purchasemethod(ansistring):该曲的购买方式,如果为曲包名即为购买相应曲包(前提是你已经设定该曲包是要购买的),如为歌曲ID名即为单曲购买,相信你们都知道该干什么,可留空.
  • Preview1,Preview2(ms):预览时间的开始与结束,数字为整数
  • side(0,1):歌曲属性是光(0)还是对立(1),别想了其他的只是背景.
  • worldBoolean(false,true):该曲是否需要在world里解锁,true为是,false为不是,相信你们都知道该干什么,可删除.
  • ppBoolean(false,true):在游戏内没有差异性,但只有lowiro没有拿到全部版权的曲目该选项为true,可删除
  • setBG(ansistring):本曲的背景,背景文件必须能在\assets\img\bg里找到,不能出现非ASCII字符.可留空后,游戏自动安排默认。
    • 附属属性有bg_daynight,
  • date(Time):加入时的系统时间戳,参考转换成Unix时间戳
  • remoteDLBoolean(false,true):该曲目是否需要远程下载,true为是,false为否.如果为true,预览音频在对应文件夹里,相应谱面文件夹里也没有音频文件,相信你们都知道该干什么,可删除.
  • bydBoolean(false,true):该曲目的Beyond难度是否能在本地解锁。(实际不起作用)可删除
  • version(ansistring):本曲加入游戏的版本,用于折叠歌曲显示。
  • hiddenBoolean(false,true):标识该曲目是否在歌曲界面中隐藏,通常用于魔王曲解锁可删除
  • source(ansistring):本曲的来源,一般只填en以让所有语言看见。在显示时由中文书名号(《》)括起。可删除
  • ©copyright(ansistring):本曲所属版权。在显示时在中文书名号(《》)后面。可删除

难度文件解析

难度谱面信息框架如下

"difficulties": [{PST信息},{PRS信息},{FTR信息}]

各难度代码结构如下

     {
        "ratingClass": ratingClass,
        "chartDesigner": "chartDesigner",
        "jacketDesigner": "illustrator",
        "rating": rating,
        "ratingPlus": ratingBoolean,
        "plusFingers": plusFingersBoolean,
        "jacketOverride": jacketOverrideBoolean,
        "hidden_until_unlocked": hiddenBoolean
      }
  • ratingClass(0,1,2,3):本段代码对应的难度,0=PST,1=PRS,2=FTR,3=BYD
  • chartDesigner(ansistring):谱师名,可以填任何字符
  • illustrator(ansistring):封面图作者,可以填任何字符,可留空
  • rating(int):本谱难度,其中0对应?
  • ratingBoolean(false,true):本谱难度是否为“+”,可删除
  • plusFingersBoolean(0,1):加一根手指,目前尚不清楚该参数含义,据猜测可能是多点触控开关,0为关,1为开.尚不清楚之间的差别.
  • jacketOverrideBoolean(false,true):标识本难度是否独占封面图,是true否false,可删除
  • hiddenBoolean(false,true):标识本谱子是否在解锁前隐藏,可删除


综合

如果你在做完自制谱之后,采取的是替换原信息(不改ID)的方式导入的话,你也许还能登录游玩.

如果你采取了添加的方式,那么你的arc绝对不能登录,因为arc登录后会校验歌单.进而导致封号风险.

从这里开始就会涉及到危险操作了,请为自己的行为负责!