歌曲信息(songlist)格式

来自Arcaea中文维基
Cyxw讨论 | 贡献2018年2月1日 (四) 08:58的版本 →‎文件头
  • 等一下你们先让我看一下apk
  • 本页保持孤立!

在开始阅读之前

总论

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

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

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

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

阅读总论

songlist是按照json格式编写的,有大量花括号与中括号,中间的回车与制表符除了整理版面之外没有任何意义.总之不该你改的东西你不要改就行了.

代码解析

框架

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

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

可见歌曲信息之间的互不干扰性,而且它告诉我们加入自制谱(不是替换官谱)是可能的

细节解析

以一个最复杂的为例(笑)

 {
     "id": "axiumcrisis",
     "title_localized": {
       "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"
         }
       }
     ]
   }

好了让我们忘掉上面的东西,我怕你们看完后直接不看了#(滑稽)

真正归纳起来是这样的


 {
     "id": "id",
     "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]"
         }
       }
     ]
   }

希望大家能看出来哪些是变量(笑)


文件头

 {
     "id": "id",
     "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": [……
       ]
   }

id(ansistring):歌曲ID名,至关重要,像解锁条件等引用歌曲的时候是引用id的,并且对应谱面文件夹也必须是id名,如果是远程下载的曲子,在preview文件夹里放预览音频时,文件名也必须和id一样,不能出现非ASCII字符

title_localized(ansistring):长这样

 "title_localized": {
       "en": "title",
       "ja": "タイトル"
     },

其中title是你要填的曲名,"en"是英文,"ja"是日文,"ko"是韩文(从来没出现),简中繁中什么的再等等,默认语言(估计)为英文,可以填任何字符,当出现多个语言时用逗号隔开.

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语句决定.

1.5之后,所有BPM≥180的曲子该数值都调成了180

当你的谱面有瞬间出现这样的设计时,建议将该数值写成三个谱面文件里出现的最高的BPM,不过当基准BPM≥180时请想想这样做谱面猎奇的可能性.

以及这个数值就不要傻到填0或负数了,读也许能读,但……

setpack(ansistring):该曲目所隶属的曲包,请移步曲包信息(packlist)格式

purchasemethod(ansistring):该曲的购买方式,如果为曲包名即为购买相应曲包(前提是你已经设定该曲包是要购买的),如为歌曲ID名即为单曲购买,相信你们都知道该干什么,可留空.

Preview1,Preview2(ms):预览时间的开始与结束,数字为整数

side(0,1):歌曲属性是光(0)还是对立(1),别想了其他的只是背景.

worldBoolean(false,true):该曲是否需要在world里解锁,true为是,false为不是,相信你们都知道该干什么,可删除.

setBG(ansistring):本曲的背景,背景文件必须能在\assets\img\bg里找到,不能出现非ASCII字符.

date(Time):加入时的系统时间,至于真正该填什么请将当前时间转换成秒数或者打开CE查看explorer.exe……

remoteDLBoolean(false,true):该曲目是否需要远程下载,true为是,false为否.如果为true,预览音频在\assets\songs\preview里,相应谱面文件夹里也没有音频文件,相信你们都知道该干什么,可删除.

难度文件解析

难度谱面信息框架如下

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

各难度代码结构如下

     {
        "ratingClass": ratingClass,
        "chartDesigner": "chartDesigner",
        "jacketDesigner": "illustrator",
        "rating": rating,
        "plusFingers": plusFingersBoolean,
        "story": {
          "en": "English Story",
          "ja": "日本語の物語"
        }
      }

ratingClass(0,1,2):本段代码对应的难度,0=PST,1=PRS,2=FTR

chartDesigner(ansistring):谱师名,可以填任何字符

illustrator(ansistring):封面图作者,可以填任何字符,可留空

rating(1,2,……,11):本谱难度,从1~11分别对应1,2,……,9+,10.请不要瞎填.

plusFingersBoolean(0,1):加一根手指,目前尚不清楚该参数含义,据猜测可能是多点触控开关,0为关,1为开.尚不清楚之间的差别.原版中只有DataErr0r [FTR],以及Grievous Lady [PRS] [FTR]该数值为1.

story:基本上跟title_localized差不多,展现的是本曲的剧情.瞎编日常.

 "story": {
            "en": "English Story",
            "ja": "日本語の物語"
           },

其中换行符为\n

本段代码若不需要可删除。

综合

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

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

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