歌曲信息(songlist)格式:修订间差异

来自Arcaea中文维基
→‎细节解析:​修复错误
标签移动版编辑 移动版网页编辑
无编辑摘要
第65行: 第65行:


 以下为歌曲信息最完整的格式。
 以下为歌曲信息最完整的格式。
''(歌曲信息中每一项的填写可以乱序,没有顺序要求)''


  {
  {
  "idx": int,
   "id": string (ASCII),
   "id": string (ASCII),
   "title_localized": {
   "title_localized": {
第112行: 第114行:
     "jacket_night": string (ASCII),
     "jacket_night": string (ASCII),
     "jacketOverride": boolean,
     "jacketOverride": boolean,
    "audioOverride": boolean,
     "hidden_until_unlocked": boolean,
     "hidden_until_unlocked": boolean,
     "bg": string (ASCII),
     "bg": string (ASCII),
第124行: 第127行:


  {
  {
  "idx": int,
   // 游戏内"Link Play"功能用来判断各玩家歌曲解锁情况时用的唯一标识符 '''必须字段'''
 
   "id": string (ASCII),
   "id": string (ASCII),
    // 游戏程序识别歌曲的唯一ID '''只能使用ASCII字符''' '''必需字段'''
    // 游戏程序识别歌曲的唯一ID '''只能使用ASCII字符''' '''必需字段'''
第130行: 第136行:
    "en": string,
    "en": string,
    "ja": string ...
    "ja": string ...
   },
   },// 游戏内显示的曲名,可分语言设定 '''必需字段'''
   // 游戏内显示的曲名,可分语言设定 '''必需字段'''
    
    
   "artist": string,
   "artist": string,
第137行: 第142行:
    "en": string ...
    "en": string ...
   },// 游戏内显示的作曲者,可分语言设定。可只填artist,默认为英语 '''必需字段'''
   },// 游戏内显示的作曲者,可分语言设定。可只填artist,默认为英语 '''必需字段'''
 
   "bpm": string,
   "bpm": string,
    // 游戏内显示的BPM '''必需字段'''<!--一些额外的曲目信息可以放在此字符串内-->
    // 游戏内显示的BPM '''必需字段'''<!--一些额外的曲目信息可以放在此字符串内-->
 
   "bpm_base": float,
   "bpm_base": float,
    // 基准BPM,实际游玩速度为设置的音符流速除以"bpm_base"再乘以谱面Timing bpm '''必需字段'''
    // 基准BPM,实际游玩速度为设置的音符流速除以"bpm_base"再乘以谱面Timing bpm '''必需字段'''
第192行: 第197行:
   "source_copyright": string,
   "source_copyright": string,
    // 本曲版权方,仅当"source_localized"不为空时显示在 from 「」之后
    // 本曲版权方,仅当"source_localized"不为空时显示在 from 「」之后
 
 
   "no_stream": boolean,
   "no_stream": boolean,
    // 本曲是否能够在直播模式中游玩
    // 本曲是否能够在直播模式中游玩
第215行: 第220行:
    {
    {
     "ratingClass": int (0, 1, 2, 3),
     "ratingClass": int (0, 1, 2, 3),
      // 本段代码所定义难度。0 -- PST, 1 -- PRS, 2 -- FTR, 3 -- BYD '''必需字段''' ''3.0修改''
      // 本段代码所定义难度。0 -- PST, 1 -- PRS, 2 -- FTR, 3 -- BYD '''必需字段'''
      
      
     "chartDesigner": string,
     "chartDesigner": string,
第224行: 第229行:
      
      
     "rating": int,
     "rating": int,
      // 本难度等级。3.0更新前1-9对应本身,10对应9+,11对应10;3.0更新后均 本身。0均对应? '''必需字段''' ''3.0修改''
      // 本难度等级。3.0更新前1-9对应本身,10对应9+,11对应10;3.0更新后均 对应 本身。0均对应 ? '''必需字段'''
      
      
     "ratingPlus": boolean,
     "ratingPlus": boolean,
第230行: 第235行:
      
      
     "plusFingers": boolean,
     "plusFingers": boolean,
      // 本难度是否有多指操作,实际并无作用<ref>官方songlist中最后含有本参数的谱面是[[Ether Strike]] FTR、[[Fracture Ray]] PRS&FTR;[[World Vanquisher]]及以后一些谱面也出现了多押但没有使用本参数</ref>
      // 本难度是否有多指操作,实际并无作用<ref>官方songlist中最后含有本参数的谱面是[[Ether Strike]] FTR、[[Fracture Ray]] PRS&FTR、[[Grievous Lady]] PRS&FTR、[[DataErr0r]] FTR;[[World Vanquisher]]及以后一些谱面也出现了多押但没有使用本参数</ref>
      
      
     "jacket_night": string (ASCII),
     "jacket_night": string (ASCII),
第237行: 第242行:
     "jacketOverride": boolean,
     "jacketOverride": boolean,
      // 本难度是否有根据难度替换的封面。封面文件名为0.jpg,0_256.jpg(即为"ratingClass"),不填默认为false
      // 本难度是否有根据难度替换的封面。封面文件名为0.jpg,0_256.jpg(即为"ratingClass"),不填默认为false
   
    "audioOverride": boolean,
     // 本难度是否有根据难度替换的音频文件。音频文件名为3.ogg(即为"ratingClass"),不填默认为false
      
      
     "hidden_until_unlocked": boolean,
     "hidden_until_unlocked": boolean,
      // 本难度解锁前是否歌曲界面中隐藏,不填默认为false ''3.0新增''
      // 本难度解锁前是否歌曲界面中隐藏,不填默认为false
      
      
     "bg": string (ASCII),
     "bg": string (ASCII),
      // 自定义本难度背景名,背景jpg储存在/assets/img/bg目录中 '''只能使用ASCII字符'''
      // 自定义本难度背景名 ,对于安卓apk ,背景jpg储存在/assets/img/bg目录 中;对于苹果ipa,背景jpg储存在/Payload/Arc-mobile.app/img/bg 中 '''只能使用ASCII字符'''
      
      
     "world_unlock": boolean
     "world_unlock": boolean

2022年4月5日 (二) 17:31的版本


在您查看以下内容之前,我们需要您回答我们提供的问题。
ABA型的三字符songid是?
已确认。

  • 本页保持孤立!

在开始阅读之前

总论

本文件是关于更改歌曲信息的。

关于谱面本身的格式,请移步谱面格式

关于解歌条件的部分,请移步解锁条件(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(否)
  • 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),
  "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,
      "audioOverride": boolean,
      "hidden_until_unlocked": boolean,
      "bg": string (ASCII),
      "world_unlock": boolean
    } ...
  ]
}

歌曲信息

注:以下必需字段指官方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),
    // 本曲属性,0为光芒侧,1为纷争侧 必需字段
  
  "bg": string (ASCII),
    // 本曲背景文件名,背景jpg储存在/assets/img/bg目录中,留空即为默认背景(base_light(光芒侧)或base_conflict(纷争侧)) 只能使用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 「」之后
  
  "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 必需字段
      
      "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]
      
      "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字符
      
      "world_unlock": boolean
        // 本难度是否需要世界模式解锁,不填默认为false
    }
  1. 官方songlist中最后含有本参数的谱面是Ether Strike FTR、Fracture Ray PRS&FTR、Grievous Lady PRS&FTR、DataErr0r FTR;World Vanquisher及以后一些谱面也出现了多押但没有使用本参数