歌曲信息(songlist)格式

• 等一下你們先讓我看一下apk

• 本頁保持孤立!

在開始閱讀之前

總論

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

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

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

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

閱讀總論

songlist是按照json格式編寫的,有大量花括號與中括號,中間的回車與制表符除了整理版面之外沒有任何意義.總之不該你改的東西你不要改就行了.

代碼解析

框架

歌曲信息在文件里總體排列成這樣

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

可見歌曲信息之間的互不干擾性,而且它告訴我們加入自製譜(不是替換官譜)是可能的.任何較大的改動都會使arc崩潰.

細節解析

以一個最複雜的為例(笑)

 {
     "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.請不要瞎填.
• plusFingersBoolean(0,1):加一根手指,目前尚不清楚該參數含義,據猜測可能是多點觸控開關,0為關,1為開.尚不清楚之間的差別.
• jacketOverrideBoolean(false,true):標識本難度是否獨佔封面圖，是true否false，可刪除

綜合

如果你在做完自製譜之後,採取的是替換原信息(不改ID)的方式導入的話,你也許還能登錄遊玩.

如果你採取了添加的方式,那麼你的arc絕對不能登錄,因為arc登錄後會校驗歌單.進而導致封號風險.

從這裏開始就會涉及到危險操作了,請為自己的行為負責!