解鎖條件(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，3。0為PST難度，1為PRS難度，2為FTR難度，3為BYD難度。
• conditions：unlocks文件中的核心，以一對英文方括號包裹，每一個condition語句組以一對大括號包含。一個歌曲的一個難度可以有很多個condition語句組，它們之間以英文逗號分開。

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

type 0：殘片型解鎖

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

當type取0時，為殘片型解鎖。玩家需要花費殘片來開啟當前歌曲的遊玩權限。

• credit (int)：指解鎖當前難度歌曲需要花費的殘片數量。

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

type 1：先行通過歌曲型解鎖

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

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

• song_id (string)：指在遊玩本難度的歌曲時，需要先行通過的歌曲名稱，引用要求與songId相同。
• song_difficulty (int)：取值為0/1/2/3/4，與ratingClass含義相同。
• grade (int)：限定先行通過的歌曲需要達到的評級，數字對應條件見下表。

條件	評級
0	不限定
1	C
2	B
3	A
4	AA
5	EX
6	EX+

type 2：先行遊玩歌曲型解鎖

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

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

type 3：多次通過歌曲型解鎖

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

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

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

type 4：選擇任務型解鎖

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

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

type 5：個人遊玩潛力值型解鎖

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

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

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

type 6：多次通過對應等級歌曲型解鎖

{
     "type": 6,    
     "count": countNum,
     "rating": ratingNum,
     "ratingPlus": boolean
}

type取6時，為多次通過對應等級歌曲型解鎖，與多次通過歌曲型解鎖相似，不過需要多次通過相應等級的歌曲。

• count (int)：跟上文的多次通過歌曲型解鎖中的times同理。
• rating (int)：指限定的遊玩等級。
• ratingPlus (boolean)：可以不存在於條件內，用來設定等級的「+」，true為設定，false為不設定，該語句不存在於條件內時默認為false。

type 7：先行解鎖對應曲目難度型解鎖

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

type取7時，為先行解鎖對應曲目難度型解鎖，與先行遊玩歌曲型解鎖相似，不過只需要解鎖曲目的對應難度，不需要遊玩曲目。

type 8：以特定通關類型通過對應曲目解鎖

{
    "type": 8,
    "song_id": "songname",
    "song_difficulty": "difficulty",
    "lamp":"number",
}

type取8時，需要以特定的通關條件通過對應的曲目。（此條件在V5.10隨著Inverted World[ETR]出現）

lamp	條件
0	Track Lost
1	Track Complete(Normal Clear)
2	Full Recall
3	Pure Memory
4	Track Complete(Easy/綠C)
5	Track Complete(Hard/紅C)

type 101：特殊解鎖類型

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

type取101時，為特殊解鎖類型，通常用於解鎖異象曲/終末曲。

• min (int)：解鎖異象曲或終末曲失敗時獲得的最小進度數。
• max (int)：解鎖異象曲或終末曲失敗時獲得的最大進度數。

type 102：特殊挑戰類型

本類型不會在unlocks文件中出現，但是在本地記錄解鎖狀態的文件中可以發現本類型。
目前使用本類型解鎖條件的曲目有Aegleseeker、Testify與Tempestissimo（包含解鎖前的四個挑戰與曲目本身的pst難度）

type 103：搭檔解鎖類型

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

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

除曲目Aegleseeker和Arghena外，在普通曲目上使用該解鎖類型會導致使用對應搭檔遊玩結束並返回到選曲界面後切換為其他搭檔後對應曲目不顯示曲繪和曲目信息(但可正常選擇該曲目進入遊戲)。

• id (int): 該曲解鎖時所需的搭檔(此處值不可為-1)，數字對應搭檔見下

type 104：劇情解鎖類型

{
    "type": 104
}

type取104時，通常不會有其他語句一起存在，但type 104出現且僅出現於Final Verdict及其附加內容Silent Answer的所有曲目中（開門曲Defection除外）

type 105：搭檔技能解鎖類型

{
    "type": 105,
    "char_id": int,
    "awakened": boolean,
    "inverted": boolean
}

type取105時，為搭檔技能解鎖類型，目前僅有Last｜Eternity的byd難度存在該解鎖條件。

• char_id (int): 和type103的id作用相同，此處不再贅述。
• awakened (boolean)、inverted (boolean): 當搭檔技能為覺醒技能/未覺醒技能時是否顯示該難度，true為顯示，false為不顯示。

type 106：綁定譜面解鎖類型

{
    "type": 106,
    "song_id": string,
    "song_difficulty": int,
    "inverted": boolean
}

type取106時，為綁定譜面解鎖類型（存疑），目前僅有Last的byd難度（即Last｜Moment）存在該解鎖條件。

• song_id (string): 曲目的songid。
• song_difficulty (int): 捆綁曲目的難度。
• inverted (boolean): 當搭檔技能為未覺醒技能時是否顯示該難度，true為顯示，false為不顯示。

type 107：解謎解鎖類型

{
    "type": 107
}

type取107時，為Magnolia的解謎挑戰，若且唯若玩家購買了所在曲包時挑戰才會生效。在完成本挑戰前，歌曲將不展示曲封、不播放預覽音樂，具體挑戰內容請查看單曲頁面。

type 108：故事解鎖類型

{
    "type": 108
}

type取108時，為故事解鎖類型。目前僅有Arghena使用了本解鎖條件，在未完成挑戰前，餘下的解鎖挑戰將不會顯示。

type 109：特殊解謎挑戰類型

{
     "type": 109,
     "index": int,
     "difficulty": int
},

type取109時，為特殊解謎挑戰類型。目前僅有Arghena使用了本解鎖條件。

• index (int): 解謎項目的索引（存疑）。
• difficulty (int): 曲目難度。

type 110：偽段位挑戰類型

{
     "type": 110
},

type取110時，為偽段位挑戰類型。目前僅有Arghena使用了本解鎖條件。與常規的段位挑戰類似但是允許暫停。

參考資料

注釋