解锁条件(unlocks)格式

在您查看以下內容之前，我們需要您回答我們提供的問題。
ABA型的三字符songid是？

已確認。

技術型隱藏頁面索引

譜面格式 · 曲包信息格式 · 解鎖條件格式 · 歌曲信息格式 · 劇情格式

• 本頁面內容保持孤立！

總論

文件在\assets\songs下

打開文件大概是這樣的畫風：

{
 "unlocks": [
   {
     "songId": …,
     "ratingClass": …,
     "conditions": [
       …
       ],
       …
   },
   …
 ]
}

整個文件以一個大括號和一個」unlocks」字符串開頭，大體結構如下

{
"unlocks":[
//all contents…
]
}

細節解析

例子

{
     "songId": "chronostasis",
     "ratingClass": 1,
     "conditions": [
       {
         "type": 1,
         "song_id": "infinityheaven",
         "song_difficulty": 1,
         "grade": 0
       },
       {
         "type": 0,
         "credit": 80
       }
     ]
}

歸納

{
  "songId": this.songname,
  "ratingClass": classNum,
  "conditions": [
    {
     //condition 1
    },
    {
     //condition 2
    }
 ]  //end of condition(s)
}

從上到下依次解析如下：

• songId (String）：雙引號包含的字符串，代表了欲限定條件的歌曲名稱。至關重要，所引用歌曲對應譜面文件夾也必須是id名，不能出現非ASCII字符
• ratingClass (int)：代表了欲限定條件的歌曲難度，取值只能為0，1，2。0為PST難度，1為PRS難度，2為FTR難度。
• conditions：unlocks文件中的核心，以一對英文方括號包裹，每一個condition語句組以一對大括號包含。一個歌曲的一個難度可以有很多個condition語句組，它們之間以英文逗號分開。

每一個語句組中一定有一個type語句，根據type的取值不同，其中會有不同的呈現。

殘片型解鎖

{
   "type": 0,
   "credit": frag_needed_to_unlock
}

當type取0時，為殘片型解鎖。玩家需要花費殘片來開啟當前歌曲的遊玩權限。credit的取值是一個整數，代表了解鎖當前難度歌曲需要花費的殘片數量。

在該解鎖條件情況下，花費殘片後可以永久解鎖對應譜面，意味著解鎖後其他條件不滿足時對應譜面不會鎖回去。

先行通過歌曲型解鎖

{
    "type":1,    
    "song_id": songname,
    "song_difficulty": difficulty,
    "grade": gradeNum
}

type取1時，為先行通過歌曲型解鎖，玩家需要在其前置歌曲中達到相應要求。

• song_id (String)：指在遊玩本難度的歌曲時，需要先行通過的歌曲名稱，引用要求與songId相同。
• song_difficulty (int)：取值為0，1，2，與ratingClass含義相同。
• grade (int)：限定先行通過的歌曲需要達到的評級，0為不限定，1為達到C，2為達到B，3為達到A，4為達到AA，5為達到EX，6為達到EX+。

先行遊玩歌曲型解鎖

{
    "type":2,    
    "song_id": songname,
    "song_difficulty": difficulty
}

type取2時，為先行遊玩歌曲型解鎖，與先行通過歌曲型解鎖類似，不過對應結果為遊玩相應曲目即可。變量不再贅述。

多次通過歌曲型解鎖

{
    "type":3,    
    "song_id": songname,
    "song_difficulty": difficulty,
    "grade": gradeNum,
    "times": timesNum
}

type取3時，為多次通過歌曲型解鎖，與先行通過歌曲型解鎖類似，不過需要多次通過相應曲目並達到給定評級。

• times (int)：指先行通過的歌曲需要達到限定評級的次數。

其他變量不再贅述。

選擇任務型解鎖

{
    "type":4,
    "conditions": [
    {
     //condition 1
    },
    {
     //condition 2
    }
 ]  //end of condition(s)
}

type取4時，為選擇任務型解鎖。其中conditions類似最外側的conditions，可填入不同的condition語句組。玩家只需挑選其中任意一個任務完成即可解鎖。套娃警告

個人遊玩潛力值型解鎖

{
    "type":5,    
    "rating": potentialNum
}

type取5時，為個人遊玩潛力值型解鎖，玩家需要取得或超過限定的潛力值即可解鎖。

• rating (int)：指限定的個人遊玩潛力值乘以100後的整數。可以隨便填，負數都行，但即使填負數在未登錄狀態下本條件仍然算未達成

特殊解鎖類型

{
   "type": 101,
   "min": minNum,
   "max": maxNum
}

type取101時，為特殊解鎖類型，通常用於解鎖隱藏歌曲。

• min (int)：解鎖anomaly失敗時獲得的最小進度數。
• max (int)：解鎖anomaly失敗時獲得的最大進度數。

搭檔解鎖類型

{
   "type": 103,
   "id": int
}

type取103時，為搭檔解鎖類型。目前僅有Aegleseeker出現此種解鎖方式。

• id (int): 該曲解鎖時所需的搭檔，-1為無（未經測試），數字對應搭檔見下