解锁条件(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为无（未经测试），数字对应搭档见下