songlist:修订间差异

来自个人维基
跳转到导航 跳转到搜索
夜鳥葉月留言 | 贡献
无编辑摘要
夜鳥葉月留言 | 贡献
无编辑摘要
第30行: 第30行:
===细节解析===
===细节解析===


  {
*数据格式:
      "id": "id",
**string -- 字符串 例:"brandnewworld"
      "title_localized": {
**int -- 整数 例:54401
        "en": "title"
**boolean -- 布朗值 例:true(是), false(否)
        "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,
        }
      ]
    }


希望大家能看出来哪些是变量(笑)
*localized字段可选属性:
**"en" -- 英文 '''默认语言'''
**"ja" -- 日文
**"ko" -- 韩文
**"zh-Hans" -- 简体中文
**"zh-Hant" -- 繁体中文


以下为歌曲信息最完整的格式。


====文件头====
{
 
  "id": string (ASCII),
 
  "title_localized": {
  {
    "en": string ...
      "id": "id",
  },
      "title_localized": {
  "artist": string,
        "en": "title"
  "artist_localized": {
        "ja": "日本語の表記"
    "en": string ...
      },
  },
      "artist": "artist",
  "bpm": string,
      "bpm": "BPM",
  "bpm_base": int,
      "bpm_base": BPM_Base,
  "set": string,
      "set": "setpack",
  "purchase": string,
      "purchase": "purchasemethod",
  "audioPreview": int,
      "audioPreview": Preview1,
  "audioPreviewEnd": int,
      "audioPreviewEnd": Preview2,
  "side": int (0, 1),
      "side": side,
  "bg": string (ASCII),
      "world_unlock": worldBoolean,
  "bg_daynight": {
      "no_pp": ppBoolean,
      "day": string (ASCII),
      "bg": "setBG",
      "night": string (ASCII)
      "date": 加入时的系统时间,
  },
      "remote_dl": remoteDLBoolean,
  "date": int (timestamp),
      "source_localized": {
  "version": string,
        "en": "source"
  "world_unlock": boolean,
      },
  "remote_dl": boolean,
      "source_copyright": "©copyright",
  "byd_local_unlock": boolean,
      "difficulties": [……
  "songlist_hidden": boolean,
        ]
  "no_pp": boolean,
    }
  "source_localized": {
 
    "en": string ...
*id(ansistring):歌曲ID名,'''至关重要''',像解锁条件等引用歌曲的时候是引用id的,并且对应谱面文件夹也必须是id名,如果是远程下载的曲子,在preview文件夹里放预览音频时,文件名也必须和id一样,'''不能出现非ASCII字符'''
  },
*title_localized(ansistring):长这样
  "source_copyright": string,
{| class="wikitable"
  "jacket_localized": {
|-
    "ja": boolean ...
|
  },
  "title_localized": {
  "difficulties": [
        "en": "title",
    {
        "ja": "タイトル"
      "ratingClass": int (0, 1, 2, 3),
      },
      "chartDesigner": string,
|}
      "jacketDesigner": string,
:*其中title是你要填的曲名,"en"是英文,"ja"是日文,"ko"是韩文(从来没出现),"zh-Hans"为简中,"zh-Hant"为繁中,默认语言为英文,'''可以填任何字符''',当出现多个语言时用逗号隔开。
      "rating": int,
:**jacket_localized类似,不过是关于封面
      "ratingPlus": boolean,
*artist(ansistring):曲作者名,没有语言区别,'''可以填任何字符'''。
      "plusFingers": boolean,
*BPM(ansistring):向玩家显示本曲的BPM,'''可以填任何字符''',<s>这意味着我填"0-∞"是可以的</s>。
      "jacket_night": string (ASCII),
*BPM_Base:这个要注意一下,'''它表示Hi-Speed最大时用于计算的BPM''',与谱面BPM毫无关联。<s>游玩时,谱面的Hi-Speed不会大于该数值*你的Hi-Speed设置倍数</s>。(AC出现了99999.00的BPM但Base依然170)'''真正的Hi-Speed依然由谱面内的Timing语句决定。'''
      "jacketOverride": boolean,
**当你的谱面有瞬间出现这样的设计时,'''建议将该数值写成三个谱面文件里出现的最普遍的BPM''',<s>不过当基准BPM≥180时请想想这样做谱面猎奇的可能性</s>。
      "hidden_until_unlocked": boolean,
***<s>以及这个数值就不要傻到填0或负数了,读也许能读,但……</s>
       "bg": string (ASCII),
*setpack(ansistring):该曲目所隶属的曲包,请移步[[packlist]]
      "world_unlock": boolean
*purchasemethod(ansistring):该曲的购买方式,如果为曲包名即为购买相应曲包(前提是你已经设定该曲包是要购买的),如为歌曲'''ID'''名即为单曲购买,<s>相信你们都知道该干什么</s>,可留空。
    } ...
*Preview1,Preview2(ms):预览时间的开始与结束,数字为整数
  ]
*side(0,1):歌曲属性是光(0)还是对立(1),<s>别想了其他的只是背景</s>。
}
*worldBoolean(false,true):该曲是否需要在world里解锁,true为是,false为不是,<s>相信你们都知道该干什么</s>,'''可删除'''。
*ppBoolean(false,true):在游戏内没有差异性,但只有lowiro没有拿到全部版权的曲目该选项为true,'''可删除'''
*setBG(ansistring):本曲的背景,'''背景文件必须能在\assets\img\bg里找到,不能出现非ASCII字符'''。''留空''后,游戏自动安排默认。
**附属属性有bg_daynight
*date(Time):加入时的系统时间,至于真正该填什么请将当前时间[http://tool.chinaz.com/Tools/unixtime.aspx 转换成Unix时间戳]<s>或者打开CE查看explorer.exe……</s>
*remoteDLBoolean(false,true):该曲目是否需要远程下载,true为是,false为否。'''如果为true,预览音频在对应文件夹里,相应谱面文件夹里也没有音频文件''',<s>相信你们都知道该干什么</s>,'''可删除'''。
*source(ansistring):本曲的来源,'''一般只填en以让所有语言看见'''。在显示时由中文书名号(《》)括起。'''可删除'''。
*©copyright(ansistring):本曲所属版权。在显示时在中文书名号(《》)后面。'''可删除'''。
 
====难度文件解析====
难度谱面信息框架如下
{| class="wikitable"
|-
| "difficulties": [{PST信息},{PRS信息},{FTR信息}]
|}
 
各难度代码结构如下
{| class="wikitable"
|-
|
      {
        "ratingClass": ratingClass,
        "chartDesigner": "chartDesigner",
        "jacketDesigner": "illustrator",
        "rating": rating,
        "ratingPlus": ratingBoolean,
        "plusFingers": plusFingersBoolean,
        "jacketOverride": jacketOverrideBoolean,
        "hidden_until_unlocked": hiddenBoolean
       }
|}
 
*ratingClass(0,1,2):本段代码对应的难度,0=PST,1=PRS,2=FTR
*chartDesigner(ansistring):谱师名,'''可以填任何字符'''
*illustrator(ansistring):封面图作者,'''可以填任何字符''',可留空
*rating(int):本谱难度,其中0对应''?''。
*ratingBoolean(false,true):本谱难度是否为“+”,'''可删除'''
*plusFingersBoolean(0,1):<s>加一根手指?</s>目前尚不清楚该参数含义,据猜测可能是多点触控开关,0为关,1为开。尚不清楚之间的差别.
*jacketOverrideBoolean(false,true):标识本难度是否独占封面图,是true否false,'''可删除'''
*hiddenBoolean(false,true):标识本难度是否在解锁前隐藏,'''可删除'''


==综合==
==综合==

2020年9月8日 (二) 09:18的版本

在开始阅读之前

总论

歌曲信息都包含在一个叫做songlist的文件里。位置为\assets\songs

这个页面是关于更改歌曲信息的,如果想更改谱面本身,请移步谱面格式

如果想更改关于解歌条件的部分,请移步unlocks

如果想更改曲包相关内容请移步packlist

阅读总论

songlist是按照json格式编写的,有大量花括号与中括号,中间的回车与制表符除了整理版面之外没有任何意义。总之不该你改的东西你不要改就行了。

代码解析

框架

本文件总体框架如下。每一首歌曲的信息互不干扰。

{
  "songs": [
    {
      // song 1
    },
    {
      // song 2
    } ...
  ]
}

细节解析

  • 数据格式:
    • string -- 字符串 例:"brandnewworld"
    • int -- 整数 例:54401
    • boolean -- 布朗值 例:true(是), false(否)
  • localized字段可选属性:
    • "en" -- 英文 默认语言
    • "ja" -- 日文
    • "ko" -- 韩文
    • "zh-Hans" -- 简体中文
    • "zh-Hant" -- 繁体中文

以下为歌曲信息最完整的格式。

{
  "id": string (ASCII),
  "title_localized": {
    "en": string ...
  },
  "artist": string,
  "artist_localized": {
    "en": string ...
  },
  "bpm": string,
  "bpm_base": int,
  "set": string,
  "purchase": string,
  "audioPreview": int,
  "audioPreviewEnd": int,
  "side": int (0, 1),
  "bg": string (ASCII),
  "bg_daynight": {
      "day": string (ASCII),
      "night": string (ASCII)
  },
  "date": int (timestamp),
  "version": string,
  "world_unlock": boolean,
  "remote_dl": boolean,
  "byd_local_unlock": boolean,
  "songlist_hidden": boolean,
  "no_pp": boolean,
  "source_localized": {
    "en": string ...
  },
  "source_copyright": string,
  "jacket_localized": {
    "ja": boolean ...
  },
  "difficulties": [
    {
      "ratingClass": int (0, 1, 2, 3),
      "chartDesigner": string,
      "jacketDesigner": string,
      "rating": int,
      "ratingPlus": boolean,
      "plusFingers": boolean,
      "jacket_night": string (ASCII),
      "jacketOverride": boolean,
      "hidden_until_unlocked": boolean,
      "bg": string (ASCII),
      "world_unlock": boolean
    } ...
  ]
}

综合

如果你在做完自制谱之后,采取的是替换原信息(不改ID)的方式导入的话,你也许还能登录游玩。

如果你采取了添加的方式,那么你的arc绝对不能登录,因为arc登录后会校验歌单,进而导致封号风险

从这里开始就会涉及到危险操作了,请为自己的行为负责!