songlist

在开始阅读之前

总论

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

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

如果想更改关于解歌条件的部分，请移步unlocks

如果想更改曲包相关内容请移步packlist

阅读总论

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

代码解析

框架

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

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

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

细节解析

以一个最复杂的为例（笑）

 {
     "id": "solitarydream",
     "title_localized": {
       "en": "Solitary Dream",
       "ja": "虚空の夢"
     },
     "jacket_localized": {
       "ja": true
     },
     "artist": "ak+q feat. Sennzai",
     "bpm": "162",
     "bpm_base": 162,
     "set": "core",
     "purchase": "core",
     "audioPreview": 49629,
     "audioPreviewEnd": 68148,
     "side": 0,
     "bg": "solitarydream",
     "remote_dl": true,
     "world_unlock": true,
     "date": 1552089600,
     "difficulties": [
       {
         "ratingClass": 0,
         "chartDesigner": "",
         "jacketDesigner": "シエラ",
         "rating": 4
       },
       {
         "ratingClass": 1,
         "chartDesigner": "",
         "jacketDesigner": "シエラ",
         "rating": 7
       },
       {
         "ratingClass": 2,
         "chartDesigner": "",
         "jacketDesigner": "シエラ",
         "rating": 8
       }
     ]
   }

好了让我们忘掉上面的东西，反正上面的东西又不全

真正归纳起来是这样的

 {
     "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": 加入时的系统时间,
     "remote_dl": remoteDLBoolean,
     "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": 加入时的系统时间,
     "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时间戳或者打开CE查看explorer.exe……
• remoteDLBoolean(false,true):该曲目是否需要远程下载，true为是，false为否。如果为true，预览音频在对应文件夹里，相应谱面文件夹里也没有音频文件，相信你们都知道该干什么，可删除。
• source(ansistring):本曲的来源，一般只填en以让所有语言看见。在显示时由中文书名号(《》)括起。可删除。
• ©copyright(ansistring):本曲所属版权。在显示时在中文书名号(《》)后面。可删除。

难度文件解析

难度谱面信息框架如下

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

各难度代码结构如下

{ "ratingClass": ratingClass, "chartDesigner": "chartDesigner", "jacketDesigner": "illustrator", "rating": rating, "plusFingers": plusFingersBoolean, "jacketOverride": jacketOverrideBoolean }

• ratingClass(0,1,2):本段代码对应的难度，0=PST，1=PRS，2=FTR
• chartDesigner(ansistring):谱师名，可以填任何字符
• illustrator(ansistring):封面图作者，可以填任何字符，可留空
• rating(0,1,2,……,11):本谱难度，从0～11分别对应?，1，2，……，9，10，11。请不要瞎填。
• plusFingersBoolean(0,1):加一根手指？目前尚不清楚该参数含义，据猜测可能是多点触控开关，0为关，1为开。尚不清楚之间的差别.
• jacketOverrideBoolean(false,true):标识本难度是否独占封面图，是true否false，可删除

综合

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

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

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