解锁条件(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 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使用了本解锁条件。与常规的段位挑战类似但是允许暂停。

参考资料

注释