歌曲信息(songlist)格式

出自Arcaea中文维基
於 2020年12月3日 (四) 14:28 由 Cyxw留言 | 貢獻 所做的修訂
  • 本頁保持孤立!

在開始閱讀之前

總論

本文件是關於更改歌曲信息的,如果想更改譜面本身,請移步譜面格式

如果想更改關於解歌條件的部分,請移步解鎖條件(unlocks)格式

如果想更改曲包相關內容請移步曲包信息(packlist)格式

閱讀總論

本文件名為songlist,包含了除教程及愚人節外的全部歌曲相關信息。

本文件在安卓apk安裝包里的位置為 \assets\songs\songlist,在蘋果ipa安裝包內位置為 \Payload\Arc-mobile.app\songs\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,
   "no_stream": boolean,
  "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,
    // 本曲加入时的游戏版本,用于歌曲分类 必需字段
  
  "world_unlock": boolean,
    // 本曲是否需要世界模式解锁
  
  "remote_dl": boolean,
    // 本曲是否需要从服务器下载
  
  "byd_local_unlock": boolean,
    // 本曲Beyond难度是否在本地解锁。应与"world_unlock"相反 
  
  "songlist_hidden": boolean,
    // 本曲解锁前是否歌曲界面中隐藏 
  
  "no_pp": boolean,
    // 标记lowiro是否拥有本曲的版权。本字段对游戏没有影响
  
  "source_localized": {
    "en": string ...
  },// 本曲出处,可分语言设定。歌曲界面中选择歌曲后,歌曲下方会显示 from 「"source_localized"」(其他语言)/《》(中文)
  
  "source_copyright": string,
    // 本曲版权方,仅当"source_localized"不为空时显示在 from 「」之后
  "no_stream": boolean,
    // 本曲是否能够在被采集卡录制/进行直播时游玩
  
  "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
        // 本难度是否需要世界模式解锁,尚无法使用
    }