「歌曲信息(songlist)格式」:修訂間差異

出自Arcaea中文维基
→‎代码解析:​ 添加 category 相关内容,添加 plusFingers 在早期版本中的描述
 
(未顯示由 24 位使用者於中間所作的 78 次修訂)
行 1: 行 1:
*<s>等一下 们先让我 一下apk</s>
<!--如果你通过查看源代码发现了这里,那么恭喜 发现了查 内容的第二种方法。
-->{{技术型}}
__NOINDEX__


{{Usercheck}}
{{特殊页面导航}}
*'''本页保持孤立!'''
*'''本页保持孤立!'''


==在开始阅读之前==
==在开始阅读之前==
===总论===
===总论===
歌曲信息都包含在一个叫做songlist的文件里.位置为\assets\songs


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


  如果想更改 关于 解歌条件 部分, 请移步[[ 解锁条件(unlocks) 格式]]
 关于 谱面本身 格式, 请移步[[ 谱面 格式]]


  如果想更改 曲包相关内容请移步[[曲包信息(packlist)格式]]
  关于解歌条件的部分,请移步[[解锁条件(unlocks)格式]]
 
关于 曲包相关内容 请移步[[曲包信息(packlist)格式]]


===阅读总论===
===阅读总论===
songlist 是按照<s>类似Java语言</s>编写的, 有大量花括号与中括号,中间 回车与制表符除了 整理版面 之外没有 任何 意义.''' 总之不该你 改的 东西你 要改 就行 '''.
 
本文件名为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都需要改一次程序)
-->


==代码解析==
==代码解析==
===框架===
===框架===
歌曲信息在文件里总体排列成这样


{| class="wikitable"
本文件总体框架如下。每一首 歌曲 息互不干扰。
|-
| <nowiki>{"songs": [{ 歌曲信 息1},{歌曲信息2},……,{歌曲信息n}]}</nowiki>
|}


可见歌曲信息之间的互不干扰性, 而且它告诉我们'''加入自制谱(不是替换官谱)'''是可能的
<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,
  "category": 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",无需购买则留空 '''必需字段'''
 
  "category": string,
   // 本曲位于单曲包 (single) 中分类,可填内容为:partner、original、variety、poprec、musicgames
 
  "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,
     // 本难度是否有多指操作,实际并无作用<ref>官方songlist中最后含有本参数的谱面是[[Ether Strike]] FTR、[[Fracture Ray]] PRS&FTR、[[Grievous Lady]] PRS&FTR、[[DataErr0r]] FTR;[[World Vanquisher]]及以后一些谱面也出现了多押但没有使用本参数</ref><ref>该字段在早期版本为 int 类型且为必须字段</ref>


  {
    "title_localized": {
    "id": "axiumcrisis",
       "en": string,
    "title_localized": {
        "ja": string ...
     "en": "Axium Crisis"
      },// 本难 显示 曲名,可 设定
    },
    "artist": "ak+q",
    "bpm": "170",
    "bpm_base": 170,
    "set": "yugamu",
    "purchase": "yugamu",
    "audioPreview": 51291,
    "audioPreviewEnd": 78820,
    "side": 1,
    "world_unlock": true,
    "bg": "axiumcrisis",
    "date": 1509667207,
    "difficulties": [
     {
      "ratingClass": 0,
      "chartDesigner": "The Monolith",
      "jacketDesigner": "シエラ",
      "rating": 5,
      "plusFingers": 0,
      "story": {
        "en": "It had been a while, and so she'd grown confident.\n\nIn the time since she began she'd explored much of this glass and mirror world, and she'd gathered countless shards. Like an unending scarf they formed around her neck and trailed long behind her. Now, she stood atop a fallen tower and looked out ahead with a smile. The terrible memories of other places twisted behind her menacingly.\n\nShe was gazing at a place that had always caught her eye, but she'd refrained from ever going toward it. It was some sort of distant labyrinth turning into the sky with insane geometry. Of course, it was more glass. Of course, she could feel its filth pulsing all the way out here.|Although she still had no idea how to go about it, she intended to be rid of the terrible fragments that followed her eventually. To that end she was gathering them. She at least took comfort in having the bad all in one place. That would make clearing it away one day all the more easier. This labyrinth was particularly bad, and she felt confident in gathering its fragments too.\n\nThe maze was surrounding by a glittering and ever-shifting sea of good memories. As she made her way toward the maze, the sea parted, only a few shards coming to join the trail behind her. However, while walking the path and scattering the good shards she suddenly hesitated. Now flanked by hope, with despair before her, she chewed on her lip...and her heart wavered.",
       "ja": "幾らかの時が経ち、彼女の自信は確かなものとなっていた。\n\nこれまで、このガラスと鏡の世界を彷徨いながら、数えきれない程の破片を集めてきた。\nまるで無限に続くスカーフのように、集まった破片が彼女の首を取り巻き、後ろへ長く続いていた。\n今、彼女は崩れた塔の上に立ち、笑顔で前方を見ている。何処かのあの恐ろしい記憶たちは、\n彼女を脅すように背後でねじれを生んでいた。\n\nいつも目が引き付けられる場所を、彼女は見つめていた。これまで、そこへ向かうのを控えていたのだ。\nそこは狂気的な幾何学模様を描き、空へと変わりゆく遥か遠い迷宮のようなものだった。当然、それは沢山のガラスだった。\n当然、その穢れの脈動は、ここからでも感じ取ることができた。|どうしたらいいのか未だ解らなかったが、彼女はいずれ、\n後に続く恐ろしい破片達を排除するつもりでいた。そのために、破片を集めてきたのだ。\n少なくとも、悪を一か所に集めることで彼女は安心できた。\nこうしておけば、然るべき時に楽に終わらせることができるだろう。\nこの迷宮は特に酷いものだったが、同時に彼女にはその破片を集めるだけの自信があった。\n\n迷路は、キラキラと輝き変化し続ける、良き思い出の欠片の海に囲まれていた。\n彼女が迷路へ向かって進むと、海は分かれ、僅か一部の破片だけが彼女の後ろに加わった。\nそのまま良き思い出の欠片を散らし歩いていたが、突然彼女は躊躇した。\n希望に囲まれ、目の前の絶望に彼女は唇を噛んだ…心が揺り動かされた。"
      }
      },
     {
      "ratingClass": 1,
      "chartDesigner": "The Monolith",
      "jacketDesigner": "シエラ",
      "rating": 8,
      "plusFingers": 0,
      "story": {
       "en": "Once upon a time, surely, things had to have been better.\n\nThe girl remembered nothing. and since awaking in the world of glass she'd only ever known other memories. Because of this, she'd drawn many conclusions and had few second thoughts. She'd been assured of the idea that nothing in the glass and nothing in this world held any worth. Filth and awfulness, tears and pain, a small smile, and death.\n\nBut once upon a time, things had to have been better. Simple rules are often true: shadows are begotten from light. Shadow lurked at her back, and now she was surrounded by light.\n\nWhen she'd stepped into these waves of joy and purity, she hadn't given it a second thought. She'd become so absorbed in evil that she had forgotten simple good. To be honest it was more than her heart simply wavering, now. She was overwhelmed. For every glint of hope that caught her eye on the way to the jagged maze, she paused and questioned everything. There was an answer she did not want to acknowledge, immersed in this scene of light and chaos. She didn't want to think about it. She wouldn’t allow herself to think about it.|And, before she really could, she stood before the entrance to the impossible labyrinth.\n\nOn impulse, she reached out to the better glass and memories of flowering fields came to follow around her in a ring. She didn't know why, nor if they would help.",
       "ja": "かつて、確かに、今よりも良い時があった筈だ。\n\n少女は何も覚えていなかった。ガラスの世界で目覚めて以来、知っているのは他の記憶だけだった。\nそのせいで彼女はほとんど迷いなく物事を断定した。\nガラスの中は無であるということ、この世界に価値など無いということ。\n汚さと恐怖。涙と痛み。少しの笑みと、死。\n\nしかし、かつて今よりも良い時があった筈なのだ。\n単純な法則というのは、大抵真実である。影は、光によって生じるのだ。\n彼女の背後には影が潜み、彼女の周囲は光で溢れていた。|喜びと純潔の波に足を踏み入れたとき、彼女に迷いは無かった。\n悪にすっかり取り込まれ、純粋な善というものを忘れてしまっていた。\n実のところ、彼女の心はもう揺り動かされるといった状態ではなかった。\n圧倒されてしまっていた。曲がりくねる迷路へと向かう途中で煌めく希望を目にする 、彼女は立ち止まり全てに疑問を呈した。\nそこには彼女の認めたくない答えがあった。この光と混沌の世界の奥底に。\n考えたくなかった。考えることを許さなかった。\n\nそして、本当に頭から取り払うことのできる前に、彼女はあの目を疑うような迷宮の前に辿り着いた。\n衝動 にガラスを見つけて手を伸ばすと、花咲く地の記憶が彼女の周囲に環を描いた。\nその理由も、それが何かの役に立つのかも、彼女には からなかった。\n"
      }
     },
     {
      "ratingClass": 2,
      "chartDesigner": "The Monolith",
      "jacketDesigner": "シエラ",
      "rating": 10,
      "plusFingers": 0,
      "story": {
       "en": "She didn't know it, but she had a name. If she knew it, perhaps she wouldn't have entered the twisted black maze. It may have been a meaningful name that may have made her doubts much stronger. But she didn't know, she ground her teeth, and she reaffirmed her beliefs. The light from before would not shake her, the light of the flower ring would not shake her. She entered the dark structure and started tearing it apart.\n\nEach wall pulled away was made of misery, each facet held horrors, and the corners were comprised of fear. This was a castle of iniquity. Simply put, it was grotesque. It was powerfully grotesque.\n\nAnd that girl, her grin returned. This was it. Climbing through it, running through it, this was the kind of disgusting monolith that had compelled her into action in the first place. She hadn't been wrong. The glass should only be shattered. The mirrors should only be destroyed.|And as she gleefully pulled away great swathes of the maze, hallways tumbling into the air, her smile became warped. She winced; something was wrong with her head. At the heart of the maze, there was *something* worse than any memory before. She could feel it, close now, calling to her. Her enthusiasm had drained, and her progress had slowed, and she saw a wicked shard of glass turning in space, containing the memory of the end of a world.\n\nWith a hand on her face, she looked into the mirrored world. She remembered the sea of pleasant realities below her and the flowers now circling around her. She'd taken down part of the maze's roof and the walls had subsequently fallen away. Dark glass rained slowly around her, and in the distance the better memories shone brightly.\n\nShe looked into the end of the world between her fingers. She swallowed, and with newfound strength, removed the hand from her face. She reached out, and dragged the end of the world into her collection of memories. With this monolith toppled, she felt an honest and genuine surge of bliss. However terrible the memories she faced from now on would be, it couldn’t possibly matter. She was certain now that she was strong, and she would definitely destroy them all. And so, with a genuine smile and a tired laugh, she came down from the sky, and the tower along with her.",
       "ja": "彼女は知らなかったが、彼女には名前があった。もし知っていたら、\n彼女はこのねじれた黒い迷路に足を踏み入れなかったかも知れない。\nもしかするとその名前の持つ意味は大きく、\n彼女の疑念もより強いものになっていたかも知れない。\nしかし彼女は知らなかった。歯ぎしりをして、自らの信念を確かめた。\n彼女は目の前の光にも、花の環の光にも揺らぐことはない。\n暗い構造物へと足を踏み入れると、乱暴に破壊を始めた。\n\n引き離された壁は苦悩から成り、全ての面は恐怖を含み、全ての角は不安でできていた。\nここは、罪悪の城だった。率直に って、不気味だった。\n強い気味の悪さを含んでいた。\n\nそして彼女はというと、笑みを取り戻していた。\n間違ってなかった。登って、走って、その気味の悪いモノリスのようなものが、\nかつての彼女を取り戻させたのだった。彼女は間違っていなかった。\nガラスは砕かれるためにあるのだ。鏡は壊されるためにあるのだ。|彼女が喜びとともに派手に迷路を破壊すると、\n廊下は宙へと崩れ落ち、彼女の笑みは歪んだ。彼女は顔をしかめた。\n頭の中で、何かが起こっていた。迷路の中心には、今までのどんな記憶よりも酷い\n「何か」があった。彼女は感じた。\nもっと近くで、彼女を呼ぶものを。\n彼女は熱意を失い、動きも鈍くなった。\nそして彼女は、宙を舞う邪悪なガラスの破片を見た。この世界の終わりの記憶を。\n\n顔に手を当てて、彼女は鏡の世界を覗き込んだ。\n彼女は下にある幸せな現実の海と、彼女の周りを回っている花を思い出した。\n彼女が迷路の屋根の一部を壊すと、それに続いて壁が崩れていった。\n暗いガラスがゆっくりと彼女の周りに降り、\n遠くに良い思い出が眩しく輝いているのが見えた。|彼女はその世界の終わりを、指の隙間から見た。\n彼女は唾を飲むと、新しい力をもって、その手を顔から離した。\n手を伸ばし、その世界の終わりを彼女の集めてきた記憶へと引き寄せた。\nそしてモノリスが倒れた時、彼女は正直な、本物の幸せの高まりを感じた。\nこれから立ち向かう記憶がどんなに酷いものであっても、どうでもよかった。\n彼女には強いという自信があった。そして、確実に全てを破壊するだろう。\nそして、純粋な笑みと疲れた笑い声とともに、彼女は空から降りてきた。\n塔も彼女に続き倒れようとしていた。\n"
      }
     }
    ]
   }


  好了让我们忘掉上面 东西, 我怕你们看完后直接不看了#(滑稽)
    "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,
    "id": "id",
     // 难度是否需要世界模式解锁,不填默认为false
    "title_localized": {
     "en": "title"
    },
    "artist": "artist",
    "bpm": "BPM",
    "bpm_base": BPM_Base,
    "set": "setpack",
    "purchase": "purchasemethod",
    "audioPreview": Preview1,
    "audioPreviewEnd": Preview2,
    "side": side,
    "world_unlock": worldBoolean,
    "bg": "setBG",
    "date": 加入时的系统时间,
    "remote_dl": remoteDLBoolean,
    "difficulties": [
     {
      "ratingClass": 0(ratingClass),
      "chartDesigner": "chartDesigner",
      "jacketDesigner": "illustrator",
      "rating": rating,
      "plusFingers": plusFingersBoolean,
      "story": {
       "en": "English Story [PST]",
       "ja": "日本語の物語 [PST]"
      }
     },
     {
      "ratingClass": 1(ratingClass),
      "chartDesigner": "chartDesigner",
      "jacketDesigner": "illustrator",
      "rating": rating,
      "plusFingers": plusFingersBoolean,
      "story": {
       "en": "English Story [PRS]",
       "ja": "日本語の物語 [PRS]"
      }
     },
     {
      "ratingClass": 2(ratingClass),
      "chartDesigner": "chartDesigner",
      "jacketDesigner": "illustrator",
      "rating": rating,
      "plusFingers": plusFingersBoolean,
      "story": {
       "en": "English Story [FTR]",
       "ja": "日 語の物語 [FTR]"
      }
     }
    ]
   }


希望大家能看出来哪些是变量( )
    "date": int (timestamp),
     // 本难度加入时刻的10位时间戳(即单位为秒的UNIX时间戳)
 
    "version": string
     // 本曲加入时的游戏版本,用于歌曲分类
   }
{{reflist}}
{{Usercheck-end}}

於 2024年9月15日 (日) 04:05 的最新修訂


在您查看以下內容之前,我們需要您回答我們提供的問題。
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,
  "category": 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",无需购买则留空 必需字段
  "category": string,
    // 本曲位于单曲包 (single) 中分类,可填内容为:partner、original、variety、poprec、musicgames
  
  "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][2]
      "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
       // 本曲加入时的游戏版本,用于歌曲分类
    }
  1. 官方songlist中最後含有本參數的譜面是Ether Strike FTR、Fracture Ray PRS&FTR、Grievous Lady PRS&FTR、DataErr0r FTR;World Vanquisher及以後一些譜面也出現了多押但沒有使用本參數
  2. 該欄位在早期版本為 int 類型且為必須欄位