「谱面格式」：修訂間差異

出自Arcaea中文维基
小無編輯摘要
 
（未顯示由 26 位使用者於中間所作的 103 次修訂）
第1行： 第1行：
<!--如果你通过查看源代码发现了这里，那么恭喜你发现了查看内容的第二种方法。-->
{{技术型}}
{{技术型}}
__NOINDEX__
{{Usercheck}}
<!--部分需下载的谱面集合缓存：https://arc.estertion.win/dl/-->
<!--Visual Studio Code aff插件下载地址：https://marketplace.visualstudio.com/items?itemName=yojohanshinwataikei.vscode-arcaea-file-format-->
{{特殊页面导航}}


*'''警告，这里只是谱面格式的介绍帖，自制谱一切后果自负！'''
*'''警告，这里只是谱面格式的介绍帖，自制谱一切后果自负！'''


*'''由于lowiro明确讲过禁止传播官方以外的版本, 所以本页面将保持孤立状态, 严禁链入/引用!'''
*'''由于lowiro明确讲过禁止传播官方以外的版本 ， 所以本页面将保持孤立状态 ， 严禁链入/引用!'''


[https://tieba.baidu.com/p/5015977438 由259WA777撰写的谱面解析]
==总论==


[https://arc.estertion.win/dl/ 神奇 的 东西]
谱面的后缀名为aff，所有在安装包中的官方谱面（即[[Arcaea]]曲包中无需世界解锁的曲目的PST/PRS/FTR/ETR难度和愚人节版本中 的 愚人节谱面）没有加密，可以直接阅读


  以下是 在 上述解析 的 基础上编写的.
  谱面所 在 位置为(Android apk)/assets/songs/<曲目id> 或 (iOS ipa)/Payload/Arc-mobile.app/songs/<曲目id>里，其中0，1，2，3，4分别对应PST，PRS，FTR，BYD，ETR。<s>其他 的 是什么东西自己打开便知道了</s>


==总 论==
理 论 上更改aff文件以及对应音源后重新正确封包即可游玩


  谱面的后缀名为aff,所有官方谱面在apk安装包中 并没有 加密,可以直接阅读.
  在该文件里 并没有 曲名、难度等级、谱师之类的歌曲信息，请移步[[歌曲信息(songlist)格式]]


  谱面所在位置为\assets\songs\( 歌 曲文 件 名) 里,其中0,1,2分别对应PST,PRS,FTR.<s>其他的是什么东西自己打开便知道了</s>
  关于解 歌 条件的部分，请移步[[解锁条 件(unlocks) 格式]]


  理论上更改aff文件以及对应音源后重新正确封包即可游玩.<s>但鉴于lowiro原因这里不会表述 关于 封 包 的 内容.</s>
 关于 曲 包 相关 内容 ，请移步[[曲包信息(packlist)格式]]


==解析==
==解析==


===文件头===
===文件头===
 所有谱面开始都 为 以下两行代码
 所有谱面 文件 开始 部分 都 一定包含 以下两 行：
{| class="wikitable"
AudioOffset:x
|-
-
| AudioOffset:x
 
<nowiki>-</nowiki>
第一 行代码 表示谱面整体向前(-)/向后(+)移动x毫秒
|}
<br>一般情况下x=0，这样物件对应的毫秒数即为歌曲播放进度的毫秒数
<br>'''但是如果x≠0，物件在音乐中实际对应的毫秒数= 物件时间+x'''
<br>''鉴于有些音源以开头为基准的第一个采音不在整拍上，所以可能有时候的确需要x≠0''
 
有些谱面会在AudioOffset行下方加入一行TimingPointDensityFactor：
AudioOffset:x
TimingPointDensityFactor:y
-
 
这行代码表示音弧和长条的物量密度调整为正常值的y倍
<br>y=1时效果与省略此行相同
<br><s> 如果y的值特别大的话...</s>


这 行 代码表示音乐整体往 前(-)/往 后(+)移动x毫秒
''注：在"-"所在的 行 之 前 ，你可以参照以上两行的格式写自己的“标注”''
<br>''例如“ChartVersion:2”，游戏会正常读取并记录相关数据，但是并不会有任何效果；物件的读取从"-"所在的行之 后 开始''


  推荐x=0, 这样你物件对应的毫秒数即为歌曲对应的音的毫秒数.
===Timing===
Timing代码如下
  timing(t,bpm,beats);


''' 但是如果x≠0,你的物件对应毫秒 数 应 为(音 对应 的 毫秒 数+x)'''
*'''t'''(ms)：Timing起始位置， 数 字 为 非负整数
*'''bpm'''( 拍/分钟)：节奏速度，数字为小数
*'''beats'''(四分 音 个数(拍))：表示每多少个四分音符(拍)为一小节（出现一条小节线），数字为小数，比如4.00就是4/4拍，代表四拍一小节
**'''需要注意 的 是每个谱面一定要有一个t=0的Timing！而且其bpm 数 值不可为负数！'''


''鉴于谱面一开始的时候会有timing, 可能有时候你真的需要x≠0.<s>懒得算了</s>''
===地面Note & 地面Hold===
地面Note & 地面Hold代码如下
(t,lane);
hold(t1,t2,lane);


 在 文件头里并没有曲名,谱师之类 的 歌曲信息, 请 移步[[ 歌曲信息(songlist)格式]]
*'''t'''(ms):地面Note所在时间，数字为非负整数
*'''t1,t2'''(ms):地面Hold物件开始/结束的时间，数字为非负整数，'''t1＜t2'''
*'''lane'''(0～5/float): 物件所 在 轨道，一般情况下轨道的编号从左到右依次为1，2，3，4，绝大部分情况下也只需要用到1~4轨道；当该值为float时候，则使用坐标作为该note的位置，float轨道坐标与arc坐标 的 映射公式为 '''-0.5 + lane * 2'''， 请 注意：如果要使用float轨道note最好是将它作为演出note使用，而不是当正常note使用，因为它的判定不同于正常轨道note的判定
**4.0.0版本起新增“enwidenlanes”的scenecontrol类型（见[[#Scenecontrol|下文]] ），在标记为启用后，轨道由4条扩充至6条，在1轨左侧新增0轨，在4轨右侧新增5轨；在不在谱面文件内标记开启“enwidenlanes”的情况下，游戏依然会正常摆放相应物件<s>（但是你打不到）</s>


 如 果想更改关于解歌条件的部分, 请移步[[解锁条件(unlocks) 格式]]
===Arc & 天空Note（Arctap）===
Arc & 天空Note（Arctap）代码 如 下
arc(t1,t2,x1,x2,easing,y1,y2,color,hitsound,skylineBoolean);


如果想 更改 曲包相关内容请移步[[ 曲包信息(packlist) 格式]]
*'''t1,t2'''(ms)：Arc物件开始/结束的时间，数字为非负整数，'''t1可以等于t2'''，当t1=t2时，Arc与判定线平行，物量为0，且此种类型的Arc可以起到连接Arc组的作用（即宏观上算作不分立的Arc，不能换手）
**只有skylineBoolean=true时t1可以大于t2
*'''x1,x2'''：代表Arc物件开始/结束时的横坐标，'''数字为小数'''
*'''easing'''(b,s,si,so)：Arc滑动方式。b =Bezier，s=Straight，si=Sine Out，so=Sine In。'''当t1=t2时该参数无意义（都是直的）'''
**si与so可以两个在一起自由组合(如siso,sisi等)，siso代表x方向上滑动方式为si、y方向上滑动方式为so
*'''y1,y2'''：代表Arc物件开始/结束时的纵坐标，'''数字为小数'''
*'''color'''：Arc颜色，0蓝，1红，2绿<ref>只有愚人节版本（v2.0.2、v2.6.1、v3.5.3、v3.12.6、v4.4.2、v5.5.6、v5.5.8）可以正常读取绿Arc，其他版本不能正常读取绿Arc</ref>，3白<ref>此Arc在4.0.0版本中的颜色为灰色，可以正常判定，并且没有换手限制；在5.5.6版本中，Arc颜色被 更改 为白色。</ref>，'''在skylineBoolean=true时该参数无意义，且能被游戏正常读取'''
**color=3的Arc在5.5.6版本中新增了'''[[#横缩放Arctap|横缩放Arctap]]'''的形态。''（目前，该Arc仅在2024年的愚人节谱面[[HIVEMIND INTERLINKED]]中出现，在其他谱面的表现形式可能不同，谨慎使用）''
*'''hitsound'''：v4.0.0实装，给予Arctap特殊打击音效，'''对整条黑线上所有的Arctap生效，'''将它们替换为特殊样式，并应用特殊打击音效。举例：填写glass_wav时，将把/(songid)/glass.wav作为打击音效，填写“none”代表不应用特殊音效，无arctap或skylineBoolean=false时，该参数无意义（但是不能乱填，起码不能让游戏崩溃），等价于填写“none”
*'''skylineBoolean'''(false,true) ：判定这一段Arc是不是天空Note的判定线（黑线）。false为普通Arc，true为天空Note的判定线，但是只要有Arctap本参数就无意义（会将此Arc的类型强制转换为天空Note的判定线）
**当skylineBoolean=true，并且该Arc上有天空Note（Arctap）时，代码如下


===Timing===
arc(t1,t2,x1,x2,easing,y1,y2,color,hitsound,true)[arctap(tn1),arctap(tn2),……,arctap(tnm)];
Timing代码如下
{| class="wikitable"
|-
| timing(Offset,BPM,Beats);
|}


Offset(ms):Timing起始位置, 数字为整数
*'''tn1,tn2,……,tnm'''(ms) ：m个天空物件在这条判定线上的时间点， 数字为 非负 整数 ，且不能超出t1和t2的区间
*实际上arctap的关键字也可以用at代替，但官方谱面中从未使用过这一别名，请谨慎使用


BPM( 拍/分钟):节奏速度,数字为不可省略小数点后两位的一个数
====横缩放Arctap====
此为color=3的Arc在5.5.6版本中新增的形态，代码如下
arc(t,t,x1,x2,easing,y,y,3,hitsound,false);


Beats(四分音个 数(拍)):表示每多少个四分音符(拍) 为 一小节,数字为 不可省略 小数点后 两位 的一个数,比如4.00就是4/4拍,四拍 一小 节
*'''t'''：Arctap的时间点， 数 字 为 非负整数。
*'''x1,x2'''：Arctap缩放起始/终止时的横坐标，''' 数字为小数'''
**以轨道俯视图为平面，作一条以x1为端点，x2为延长 点 的线段，线段长度即为Arctap缩放 后的 具体长度。
*'''easing'''：在此形态下无意义，可以填写普通Arc的任意 一个 参 数 。
*'''y'''：Arctap的纵坐标，'''数字为小数'''
*'''hitsound'''：Arctap的特殊打击音效，与普通Arc的hitsound 一 致。
**如果此参数填入了信息，Arctap也会被替换为特殊样式，但'''Arctap的大 小 保持正常形态'''（其实际判定按照原Arctap判定）


'''需要注意 的 是一定有一个Offset=0的Timing!'''
===Camera<ref>本功能在v1.7.0在代码中被标记关闭，v1.8.0中相关代码被彻底删除，但在之后 的 愚人节版本（v2.0.2、v2.6.1、v3.5.3、v3.12.6）中被恢复，且v4.0.0版本后不再被删除</ref>===


===地面Note & 地面Hold===
*于v1.6.1实装， 代码如下 ：
地面Note & 地面Hold 代码如下
camera(t,x,y,z,xozAng,yozAng,xoyAng,ease,duration);
{| class="wikitable"
|-
| (t,lane);
hold(t1,t2,lane);
|}


t(ms): 地面Note 所 在 时间,数字为整数
*以垂直判定面为基准，设横向为x轴，纵向为y轴，沿轨道方向为z轴，建立空间直角坐标系
*'''t''' (ms): 开始时间
*'''x''' (px): x轴移动，左负右正
*'''y''' (px): y轴移动，下负上正
*'''z''' (px): z轴移动，前负后正
*'''xozAng''' (deg°): xoy平面角度，逆时针-正  顺时针-负
*'''yozAng''' (deg°): yoz平面角度，抬头-正  低头-负
*'''xoyAng''' (deg°): xoz平面角度，逆时针-正  顺时针-负
*'''ease''' (preset): l, s, qi, qo, reset (l=Linear，s=Sine in&out，qi=Cubic in，qo=Cubic out，reset将camera 所 有状态重置)
*'''duration''' (ms): 语句持续 时间
''请注意，xyz轴移动的坐标并非与物件位置坐标相同。物件x坐标1.00对应850的移动距离；y坐标1.00对应450的移动距离。''


t1,t2(ms):地面Hold物件开始/结束的时间,数字为整数,'''t1＜t2'''
===Scenecontrol===


lane(1 ～4):物件所在轨道,从左到右分别为1,2,3,4
于v2.6.1 实装，代码如下：


===虹弧Arc & 天空Note===
  scenecontrol(t,type,*param1(float),*param2(int));
虹弧Arc & 天空Note代码如下
{| class="wikitable"
|-
| arc(t1,t2,x1,x2,slidemethod,y1,y2,color,FX,skylineBoolean);
|}


t1,t2(ms):虹弧Arc物件 开始/结束的 时间,数字为整数,'''t1可以等于t2''',当t1=t2 时,虹弧为直角.
*'''t'''(ms) ： 开始时间
*'''type'''：要执行的场景控制类型
*'''param''' ：参数，“*”代表可选，但是两个参数必须同 时 出现/不出现


x1,x2(-0.50～1.50): 代表Arc物件开始/结 束 时的 横坐标,官谱一般x1=0.00或1.00,''' 数字为 不可省略 小数 点后两 位 的一个 数'''
目前已知可填写的type及其参数情况如下：
:*trackhide：隐藏轨道
:*trackshow：显示轨道
:**不填参数
:**使用例：''scenecontrol(10240,trackhide);''
:*trackdisplay<!--- （v3.5.3新增? 存疑）--->：轨道透明度控制
:**''（注意：此type并未在任何官方谱面中使用过，但是包含此type的sc语句可以正常被Arcaea本体读取并正确执行，'''请谨慎使用''' ''（<s>高效率程序员看不惯单单是轨道显示/ 隐藏就写了两个type，于是造了个轮子（ 结 果惨遭忽视））</s>）
:**param1：轨道从当前alpha变换到目标alpha(param2)所要花费的 时 间，数字为小数，单位为秒，填0.00等价于填1.00
:**param2：轨道需要变换到 的 目标alpha值，可以填非负整数；<255时有黑色背景特效，否则没有；=0 为轨道完全透明，=255为轨道不透明，>=256时透明度对256取余数计算。
:**使用例：''scenecontrol(20480,trackdisplay,6.00,0);''
:*redline（v3.0.0新增）：Arcahv解锁演出时的背景红线效果
:**param1：红线存在的时间， 数字为小数 ，单 位 为秒
:**param2：未知参 数
:**使用例：''scenecontrol(40960,redline,1.88,0);''


slidemethod(b,s,si,so): 虹弧滑动方式.b=Both=Sine in & out,s=straight,si=Sine in,so=Sine out.'''当t1=t2 时 该 参数 无意义,<s>都是直的</s>'''
:*arcahvdistort（v3.0.0新增）：Arcahv解锁演出时的背景变形效果
:*arcahvdebris（v3.0.0新增）：Arcahv解锁演出时的背景碎片效果
:**param1：从当前alpha变换为指定alpha的持续时间，数字为小数，单位为秒
:**param2：目标alpha值
:**使用例：''scenecontrol(1000,arcahvdebris,1.00,128);''
:*hidegroup（v3.5.3新增）：是否隐藏该 时 间组(timinggroup)内的note(由param2决定)
:**param1：未知 参数
:**param2：隐藏或显示该时间组的note（1/0）
:**使用例：''scenecontrol(81920,hidegroup,0.00,1);''
:**需要放在时间组(timinggroup)中使用


si与so可以 两 个在一起自由组合( 如siso,sisi等)， 为 不 同方向上 的 变换效果
:*enwidencamera（v4.0.0新增）：使Camera按一定比例远离轨道，同时skyinput也会变高
:*enwidenlanes（v4.0.0新增）：使轨道两侧的ExtraLane展示
:* 两 种enwiden类型的scenecontrol的param用法如下:
:**param1：持续时长（ms）
:**param2：淡入或淡出该事件展示的效果（1/0）
:**使用例：''scenecontrol(1000,enwidencamera,1000.00,1);''
:***enwidencamera的相机移动效果实际相当于camera(t,0,450,450,0,0,0,s,duration);语句 ， 但enwidencamera会同时将Sky Input线移动至y=1.61处，同时也 不 会关闭接Arc时 的 相机抖动。


y1,y2(0.00～1.00):代表Arc物件开始/结束时的纵坐标,官谱一般y1=1.00,'''数字为不可省略小数点后两位的一个数'''
===Timinggroup===


color:虹弧颜色,0 蓝,1红,2绿,'''在skylineBoolean=true时该参数无意义'''
于v3.0.0实装，代码如下：


FX(none,full,incremental):目前尚未发掘出该参数的用途,已知本参数可以填none,full,incremental,可实际上填写时并没有区别,<s>lowiro模仿SDVX的证明(</s>
timinggroup(){
  // 正常aff语句
};


skylineBoolean(false,true):判定这 一 段虹弧是 不是 天空Note的判 定 线.false不是,为普通虹弧;true是,为天空Note 的 判定线.<s>但是只要有Arctap本参数就 无 意义 ， 都为黑线</s>
*每一个timinggroup语句块中的语句（物件）使用其内部单独的timing语句'''（并且至少包含 一 个timing语句）'''，因此可以实现同时刻不同note流速
*timinggroup语句块中的timing语句 不 会产生小节线，小节线 是 由所有timinggroup语句块外面的timing语句决 定的
*一张谱面理论可以存在 无 限多个timinggroup语句块 ， 也可以仅由t=0的timing和无数timinggroup组成


  当skylineBoolean=true,并且该判定 线 上 有 天空Note时,代码如下
  可以通过在括号内添加标识来达到特殊效果，不填则不使用任何特殊效果。不同特殊效果之间可以叠加，用下划 线 隔开即可，如timinggroup(noinput_anglex200)。<br>
目前已 有 特殊效果标识有：


{| class="wikitable"
*noinput（v3.5.3新增）：
|-
**此时本timinggroup内的物件只有显示效果，没有打击效果和物量，不会判定为击中
| arc(t1,t2,x1,x2,slidemethod,y1,y2,color,FX,true)[arctap(tn1),arctap(tn2),……,arctap(tnm)];
**noinput中的实体Arc和hold在经过判定线后依然会消失而不会直接穿过（v3.12.6起）
|}
**noinput中的实体Arc保留了部分判定，因此依然可以实现一些正常的判定特性，如当异色Arc相交时，可以用任意一只手去接/换手
***v3.12.6的愚人节曲目 [[Mistempered Malignance]] 中的同色Arc段便是利用这个特性实现的，原理是在其中一条同色Arc上放了一条完全重叠的异色noinput隐藏Arc
*fadingholds（v3.12.2新增）：
**此时在未击中Hold时，Hold会进行alpha渐变效果，直到变成未击中时的alpha
**此效果仅对timinggroup中的Hold生效，其他物件不受影响
**与noinput叠加时会正常触发fadingholds效果（但是你仍然无法击中hold）
*anglex/angley（v3.12.6新增）<ref>此机制在2023年愚人节版本4.4.2过后不久删除了部分代码，导致无法正常读取，在5.0.0版本中彻底从代码中消失，直至2024年愚人节版本5.5.6又被重新添加回来</ref>：
**分别表示对timinggroup内的天键的轨迹进行旋转，旋转轴为经过天键在判定平面落点的平行于x/y轴的直线，其后需要接一个非负整数参数，表示旋转角（单位：度）的10倍
***实际落点和判定位置不受影响
***此特殊效果仅影响天键，不影响地面tap/实体Arc/黑线
**x轴旋转时正方向为上转，y轴旋转时正方向为向左转
**两者可以叠加，叠加时先绕x轴平行线转再绕y轴平行线转，不受参数顺序影响
***例：timinggroup(angley3400_anglex200) 则会将所有天键的轨迹绕其对应的x轴平行线向上旋转20°然后绕其对应的y轴平行线向右旋转20°


tn1,tn2,……,tnm(ms):m个天空物件在这条判定线上的位置,数字为整数,'''t1≤tn1＜tn2＜……＜tnm≤t2'''
===Flick<ref>Flick从3.5.3版本起被删除了部分代码，因此Flick不能在3.5.3版本之后正常读取</ref>===


===综合===
 代码 如下：
 代码 排列顺序'''除了第一个offset=0的Timing外'''不受限制。


'''还是一句老话, 编完请自己high你不要大规模传播!!!'''
flick(t,x,y,vx,vy);


===1.6.1新特性===
*'''t'''(ms):Flick所在时间
*arc语句中,x1 x2 y1 y2参 数 可以超出限制
*'''x,y''':Flick初始位置的横、纵坐标，''' 数 字为小数'''
*'''vx,vy''':Flick滑动方向向量的横向、纵向值，'''数字为小数'''，实际滑动方位角为正右方基础上逆时针arctan(vy/vx)
*'''官方谱面目前还没有实装过Flick，请谨慎使用Flick'''


*同时多根虹弧确认可行
===综合===


* 新增camera语句
* 代码排列顺序'''除了 第一 个t=0的Timing外'''不 受限制。
**位置在 第一 个Timing语句下方,'''不 混杂在真正note语句里''',按时间顺序排列,用一个空行与真正note语句分开
*通常（无Camera）情况下，实体Arc的起始点和结束点、Arctap的坐标不应超出(-0.50,0.00)，(1.50,0.00)，(0.00,1.00) ，(1.00,1.00)四个点组成的梯形（Beyond难度中 后 两个点改为(-0.25,1.00)，(1.25,1.00) ）
{| class="wikitable"
**存在enwidencamera 的 情况 下 ，实体Arc的起始点和结束点、Arctap的坐标不应超出(-1.00,0.00)，(2.00,0.00) ，(-0.25,1.61)，(1.25,1.61)四个点组成的梯形（Beyond难度中后两个点改为(-0.63,1.61)，(1.63,1.61) ）
|-
**超出Beyond难度梯形范围可能会导致部分Arc或Arctap位于屏幕外
| camera(t,transverse,bottomzoom,linezoom,steadyangle,topzoom,angle,easing,lastingtime);
* 当Arc类型为黑线 时 ，其没有坐标界限（如 [[Dreamin' Attraction!!]] FTR的长方形隧道、[[Fracture Ray]] FTR的开头倒数），但一般来说为了美观都会将其放置在上述的梯形区 间 内
|}
**但其搭载的Arctap仍需位于坐标界限内
::*t(ms):camera开始时间
*[[Tempestissimo]] 的BYD谱面 中 间的四押的部分Arc的y坐 标 达到了1.01 ， 以此达成了整条音弧在上下剧烈颤动以及高架桥的视觉效果
::*transverse:轨道底部左右横向移动, 正←负→.
::*bottomzoom:轨道底部上下移动,正↓负↑
::*linezoom:判定线前 后 移动, 正远离负靠近
::*steadyangle( °):原地的摄像头视角转向,正逆时针负顺时针
::*topzoom:轨道顶部 的 上 下 移动, 正↓负↑
::*angle( °):底盘依照屏幕中心旋转, 正逆时针负顺时针
::*easing(qi,qo,l,reset,s):quartin,quartout,line,reset,sinein&out
::*lastingtime(ms):本语句持续 时间
:* 本功能在1.7.0在代码 中 被 标 记关闭，1.8.0中相关代码被彻底删除 ，<s>天晓得2.0怎么样</s>


===2.0.2新特性===
== 物量计算==
*camera回来了,添加s转换属性
有的时候我们并不能玩到自制谱面，这个时候我们可以通过以下方式计算本谱物量：
*添加绿蛇,种类号为2


==物量 估 算==
*统计所有地面note和arctap<!--以及flick-->数量，每统计一个+1
'''2019/1/7 已修正'''
*Hold物件逐个计算，每个hold被起始位置所在BPM的1/2拍（即8分音符，或(30000/BPM)毫秒）分成一个一个判定块，'''每个判定块开始处物量+1'''，每个Hold最后一个判定块不加物量
**BPM＞=255时，判定块间隔变为所在BPM的1拍（即4分音符，或(60000/BPM)毫秒）
**BPM=0时，'''本物件不存在'''，更无从谈及 物量
**BPM＜0时，按BPM的绝对值进行计 算
**当Hold长度短于本来的判定块长度时，整个物件对半分为两个判定块，最后一个判定块同样不计入物量
**当Hold跨越timing时，按Hold起始点的BPM进行计算
**当存在TimingPointDensityFactor时，每个判定块的时间需要除以TimingPointDensityFactor的值
*Arc物件基本与Hold相同，''' 注意每个arc语句单算'''
**持续时长为0的arc物量为0
**skylineBoolean为true时物量为0
**Arc可以连接形成Arc组，此时头Arc按照Hold方式计算，其它Arc物量+1（存疑）
***连接条件：与Arc颜色无关，要求前一个Arc结尾和后一个Arc开头x坐标差小于0.1，y坐标相等，时间差小于10
***即使不在同一timinggroup内也可以连成Arc组（具有noinput参数也可以）


有的时候我们并不 能 玩到自制谱面 ， 这个时候我们 可 以通 过 以下方式估算本谱物量：
''需要指出，Hold和Arc可 能 会出现误差 ， 原因在于末尾处 可 能刚好超 过计数 点零点几毫秒 ， 不过即使如此正常情况下误差总 计也不 会太大''
*统 计 所有地面note和arctap 数 量 ， 每统 计 一个+1
*Hold物件逐个计算，每个hold被起始位置所在BPM的osu 1/4拍( 也 就是SDVX的1/16小节)分成一个一个判定块，'''每个判定块开始处物量+1'''。
**特殊的，每个Hold最后一个判定块 不 加物量
**BPM＞255时，判定块间隔变为所在BPM的osu 1/2拍(也就是SDVX的1/8小节)
**BPM≤0时，'''本物件不存在'''，更无从谈及物量
**当Hold长度短于本来的判定块长度时，整个物件对半分为两个判定块('''无论如何最后一个判定块不计入物量''')
*Arc物件与Hold相同，'''注意每个蛇单算'''
**直角Arc不+1


'''还是一句老话，编完请你自己high，不要大规模传播!!'''


''需要指出,Hold和Arc可能会出现误差,原因在于末尾处可能刚好超过计数点零点几毫秒,不过即使如此误差总计也不会超过100.''
==注释==
{{Reflist}}
{{Usercheck-end}}

於 2024年4月24日 (三) 19:48 的最新修訂


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

技術型隱藏頁面索引

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


  • 警告，這裏只是譜面格式的介紹帖，自製譜一切後果自負！
  • 由於lowiro明確講過禁止傳播官方以外的版本，所以本頁面將保持孤立狀態，嚴禁鏈入/引用!

總論

譜面的後綴名為aff，所有在安裝包中的官方譜面（即Arcaea曲包中無需世界解鎖的曲目的PST/PRS/FTR/ETR難度和愚人節版本中的愚人節譜面）沒有加密，可以直接閱讀

譜面所在位置為(Android apk)/assets/songs/<曲目id> 或 (iOS ipa)/Payload/Arc-mobile.app/songs/<曲目id>里，其中0，1，2，3，4分別對應PST，PRS，FTR，BYD，ETR。其他的是什麼東西自己打開便知道了

理論上更改aff文件以及對應音源後重新正確封包即可遊玩

在該文件里並沒有曲名、難度等級、譜師之類的歌曲信息，請移步歌曲信息(songlist)格式

關於解歌條件的部分，請移步解鎖條件(unlocks)格式

關於曲包相關內容，請移步曲包信息(packlist)格式

解析

文件頭

所有譜面文件開始部分都一定包含以下兩行： 

AudioOffset:x
-

第一行代碼表示譜面整體向前(-)/向後(+)移動x毫秒
一般情況下x=0，這樣物件對應的毫秒數即為歌曲播放進度的毫秒數
但是如果x≠0，物件在音樂中實際對應的毫秒數=物件時間+x
鑑於有些音源以開頭為基準的第一個采音不在整拍上，所以可能有時候的確需要x≠0

有些譜面會在AudioOffset行下方加入一行TimingPointDensityFactor： 

AudioOffset:x
TimingPointDensityFactor:y
-

這行代碼表示音弧和長條的物量密度調整為正常值的y倍
y=1時效果與省略此行相同
如果y的值特別大的話...

註：在"-"所在的行之前，你可以參照以上兩行的格式寫自己的「標註」
例如「ChartVersion:2」，遊戲會正常讀取並記錄相關數據，但是並不會有任何效果；物件的讀取從"-"所在的行之後開始

Timing

Timing代碼如下 

timing(t,bpm,beats);
  • t(ms)：Timing起始位置，數字為非負整數
  • bpm(拍/分鐘)：節奏速度，數字為小數
  • beats(四分音個數(拍))：表示每多少個四分音符(拍)為一小節（出現一條小節線），數字為小數，比如4.00就是4/4拍，代表四拍一小節
    • 需要注意的是每個譜面一定要有一個t=0的Timing！而且其bpm數值不可為負數！

地面Note & 地面Hold

地面Note & 地面Hold代碼如下 

(t,lane);
hold(t1,t2,lane);
  • t(ms):地面Note所在時間，數字為非負整數
  • t1,t2(ms):地面Hold物件開始/結束的時間，數字為非負整數，t1＜t2
  • lane(0～5/float): 物件所在軌道，一般情況下軌道的編號從左到右依次為1，2，3，4，絕大部分情況下也只需要用到1~4軌道；當該值為float時候，則使用坐標作為該note的位置，float軌道坐標與arc坐標的映射公式為 -0.5 + lane * 2，請注意：如果要使用float軌道note最好是將它作為演出note使用，而不是當正常note使用，因為它的判定不同於正常軌道note的判定
    • 4.0.0版本起新增「enwidenlanes」的scenecontrol類型（見下文），在標記為啟用後，軌道由4條擴充至6條，在1軌左側新增0軌，在4軌右側新增5軌；在不在譜面文件內標記開啟「enwidenlanes」的情況下，遊戲依然會正常擺放相應物件（但是你打不到）

Arc & 天空Note（Arctap）

Arc & 天空Note（Arctap）代碼如下 

arc(t1,t2,x1,x2,easing,y1,y2,color,hitsound,skylineBoolean);
  • t1,t2(ms)：Arc物件開始/結束的時間，數字為非負整數，t1可以等於t2，當t1=t2時，Arc與判定線平行，物量為0，且此種類型的Arc可以起到連接Arc組的作用（即宏觀上算作不分立的Arc，不能換手）
    • 只有skylineBoolean=true時t1可以大於t2
  • x1,x2：代表Arc物件開始/結束時的橫坐標，數字為小數
  • easing(b,s,si,so)：Arc滑動方式。b =Bezier，s=Straight，si=Sine Out，so=Sine In。當t1=t2時該參數無意義（都是直的）
    • si與so可以兩個在一起自由組合(如siso,sisi等)，siso代表x方向上滑動方式為si、y方向上滑動方式為so
  • y1,y2：代表Arc物件開始/結束時的縱坐標，數字為小數
  • color：Arc顏色，0藍，1紅，2綠[1]，3白[2]，在skylineBoolean=true時該參數無意義，且能被遊戲正常讀取
    • color=3的Arc在5.5.6版本中新增了橫縮放Arctap的形態。（目前，該Arc僅在2024年的愚人節譜面HIVEMIND INTERLINKED中出現，在其他譜面的表現形式可能不同，謹慎使用）
  • hitsound：v4.0.0實裝，給予Arctap特殊打擊音效，對整條黑線上所有的Arctap生效，將它們替換為特殊樣式，並應用特殊打擊音效。舉例：填寫glass_wav時，將把/(songid)/glass.wav作為打擊音效，填寫「none」代表不應用特殊音效，無arctap或skylineBoolean=false時，該參數無意義（但是不能亂填，起碼不能讓遊戲崩潰），等價於填寫「none」
  • skylineBoolean(false,true)：判定這一段Arc是不是天空Note的判定線（黑線）。false為普通Arc，true為天空Note的判定線，但是只要有Arctap本參數就無意義（會將此Arc的類型強制轉換為天空Note的判定線）
    • 當skylineBoolean=true，並且該Arc上有天空Note（Arctap）時，代碼如下
arc(t1,t2,x1,x2,easing,y1,y2,color,hitsound,true)[arctap(tn1),arctap(tn2),……,arctap(tnm)];
  • tn1,tn2,……,tnm(ms)：m個天空物件在這條判定線上的時間點，數字為非負整數，且不能超出t1和t2的區間
  • 實際上arctap的關鍵字也可以用at代替，但官方譜面中從未使用過這一別名，請謹慎使用

橫縮放Arctap

此為color=3的Arc在5.5.6版本中新增的形態，代碼如下 

arc(t,t,x1,x2,easing,y,y,3,hitsound,false);
  • t：Arctap的時間點，數字為非負整數。
  • x1,x2：Arctap縮放起始/終止時的橫坐標，數字為小數
    • 以軌道俯視圖為平面，作一條以x1為端點，x2為延長點的線段，線段長度即為Arctap縮放後的具體長度。
  • easing：在此形態下無意義，可以填寫普通Arc的任意一個參數。
  • y：Arctap的縱坐標，數字為小數
  • hitsound：Arctap的特殊打擊音效，與普通Arc的hitsound一致。
    • 如果此參數填入了信息，Arctap也會被替換為特殊樣式，但Arctap的大小保持正常形態（其實際判定按照原Arctap判定）

Camera[3]

  • 於v1.6.1實裝，代碼如下：
camera(t,x,y,z,xozAng,yozAng,xoyAng,ease,duration);
  • 以垂直判定面為基準，設橫向為x軸，縱向為y軸，沿軌道方向為z軸，建立空間直角坐標系
  • t (ms): 開始時間
  • x (px): x軸移動，左負右正
  • y (px): y軸移動，下負上正
  • z (px): z軸移動，前負後正
  • xozAng (deg°): xoy平面角度，逆時針-正 順時針-負
  • yozAng (deg°): yoz平面角度，抬頭-正 低頭-負
  • xoyAng (deg°): xoz平面角度，逆時針-正 順時針-負
  • ease (preset): l, s, qi, qo, reset (l=Linear，s=Sine in&out，qi=Cubic in，qo=Cubic out，reset將camera所有狀態重置)
  • duration (ms): 語句持續時間

請注意，xyz軸移動的坐標並非與物件位置坐標相同。物件x坐標1.00對應850的移動距離；y坐標1.00對應450的移動距離。

Scenecontrol

於v2.6.1實裝，代碼如下： 

scenecontrol(t,type,*param1(float),*param2(int));
  • t(ms)：開始時間
  • type：要執行的場景控制類型
  • param：參數，「*」代表可選，但是兩個參數必須同時出現/不出現

目前已知可填寫的type及其參數情況如下：

  • trackhide：隱藏軌道
  • trackshow：顯示軌道
    • 不填參數
    • 使用例：scenecontrol(10240,trackhide);
  • trackdisplay：軌道透明度控制
    • （注意：此type並未在任何官方譜面中使用過，但是包含此type的sc語句可以正常被Arcaea本體讀取並正確執行，請謹慎使用 （高效率程式設計師看不慣單單是軌道顯示/隱藏就寫了兩個type，於是造了個輪子（結果慘遭忽視）））
    • param1：軌道從當前alpha變換到目標alpha(param2)所要花費的時間，數字為小數，單位為秒，填0.00等價於填1.00
    • param2：軌道需要變換到的目標alpha值，可以填非負整數；<255時有黑色背景特效，否則沒有；=0為軌道完全透明，=255為軌道不透明，>=256時透明度對256取餘數計算。
    • 使用例：scenecontrol(20480,trackdisplay,6.00,0);
  • redline（v3.0.0新增）：Arcahv解鎖演出時的背景紅線效果
    • param1：紅線存在的時間，數字為小數，單位為秒
    • param2：未知參數
    • 使用例：scenecontrol(40960,redline,1.88,0);
  • arcahvdistort（v3.0.0新增）：Arcahv解鎖演出時的背景變形效果
  • arcahvdebris（v3.0.0新增）：Arcahv解鎖演出時的背景碎片效果
    • param1：從當前alpha變換為指定alpha的持續時間，數字為小數，單位為秒
    • param2：目標alpha值
    • 使用例：scenecontrol(1000,arcahvdebris,1.00,128);
  • hidegroup（v3.5.3新增）：是否隱藏該時間組(timinggroup)內的note(由param2決定)
    • param1：未知參數
    • param2：隱藏或顯示該時間組的note（1/0）
    • 使用例：scenecontrol(81920,hidegroup,0.00,1);
    • 需要放在時間組(timinggroup)中使用
  • enwidencamera（v4.0.0新增）：使Camera按一定比例遠離軌道，同時skyinput也會變高
  • enwidenlanes（v4.0.0新增）：使軌道兩側的ExtraLane展示
  • 兩種enwiden類型的scenecontrol的param用法如下:
    • param1：持續時長（ms）
    • param2：淡入或淡出該事件展示的效果（1/0）
    • 使用例：scenecontrol(1000,enwidencamera,1000.00,1);
      • enwidencamera的相機移動效果實際相當於camera(t,0,450,450,0,0,0,s,duration);語句，但enwidencamera會同時將Sky Input線移動至y=1.61處，同時也不會關閉接Arc時的相機抖動。

Timinggroup

於v3.0.0實裝，代碼如下： 

timinggroup(){
 //正常aff语句
};
  • 每一個timinggroup語句塊中的語句（物件）使用其內部單獨的timing語句（並且至少包含一個timing語句），因此可以實現同時刻不同note流速
  • timinggroup語句塊中的timing語句不會產生小節線，小節線是由所有timinggroup語句塊外面的timing語句決定的
  • 一張譜面理論可以存在無限多個timinggroup語句塊，也可以僅由t=0的timing和無數timinggroup組成

可以通過在括號內添加標識來達到特殊效果，不填則不使用任何特殊效果。不同特殊效果之間可以疊加，用下劃線隔開即可，如timinggroup(noinput_anglex200)。
目前已有特殊效果標識有：

  • noinput（v3.5.3新增）：
    • 此時本timinggroup內的物件只有顯示效果，沒有打擊效果和物量，不會判定為擊中
    • noinput中的實體Arc和hold在經過判定線後依然會消失而不會直接穿過（v3.12.6起）
    • noinput中的實體Arc保留了部分判定，因此依然可以實現一些正常的判定特性，如當異色Arc相交時，可以用任意一隻手去接/換手
      • v3.12.6的愚人節曲目 Mistempered Malignance 中的同色Arc段便是利用這個特性實現的，原理是在其中一條同色Arc上放了一條完全重疊的異色noinput隱藏Arc
  • fadingholds（v3.12.2新增）：
    • 此時在未擊中Hold時，Hold會進行alpha漸變效果，直到變成未擊中時的alpha
    • 此效果僅對timinggroup中的Hold生效，其他物件不受影響
    • 與noinput疊加時會正常觸發fadingholds效果（但是你仍然無法擊中hold）
  • anglex/angley（v3.12.6新增）[4]：
    • 分別表示對timinggroup內的天鍵的軌跡進行旋轉，旋轉軸為經過天鍵在判定平面落點的平行於x/y軸的直線，其後需要接一個非負整數參數，表示旋轉角（單位：度）的10倍
      • 實際落點和判定位置不受影響
      • 此特殊效果僅影響天鍵，不影響地面tap/實體Arc/黑線
    • x軸旋轉時正方向為上轉，y軸旋轉時正方向為向左轉
    • 兩者可以疊加，疊加時先繞x軸平行線轉再繞y軸平行線轉，不受參數順序影響
      • 例：timinggroup(angley3400_anglex200)則會將所有天鍵的軌跡繞其對應的x軸平行線向上旋轉20°然後繞其對應的y軸平行線向右旋轉20°

Flick[5]

代碼如下： 

flick(t,x,y,vx,vy);
  • t(ms):Flick所在時間
  • x,y:Flick初始位置的橫、縱坐標，數字為小數
  • vx,vy:Flick滑動方向向量的橫向、縱向值，數字為小數，實際滑動方位角為正右方基礎上逆時針arctan(vy/vx)
  • 官方譜面目前還沒有實裝過Flick，請謹慎使用Flick

綜合

  • 代碼排列順序除了第一個t=0的Timing外不受限制。
  • 通常（無Camera）情況下，實體Arc的起始點和結束點、Arctap的坐標不應超出(-0.50,0.00)，(1.50,0.00)，(0.00,1.00)，(1.00,1.00)四個點組成的梯形（Beyond難度中後兩個點改為(-0.25,1.00)，(1.25,1.00)）
    • 存在enwidencamera的情況下，實體Arc的起始點和結束點、Arctap的坐標不應超出(-1.00,0.00)，(2.00,0.00)，(-0.25,1.61)，(1.25,1.61)四個點組成的梯形（Beyond難度中後兩個點改為(-0.63,1.61)，(1.63,1.61)）
    • 超出Beyond難度梯形範圍可能會導致部分Arc或Arctap位於屏幕外
  • 當Arc類型為黑線時，其沒有坐標界限（如 Dreamin' Attraction!! FTR的長方形隧道、Fracture Ray FTR的開頭倒數），但一般來說為了美觀都會將其放置在上述的梯形區間內
    • 但其搭載的Arctap仍需位於坐標界限內
  • Tempestissimo 的BYD譜面中間的四押的部分Arc的y坐標達到了1.01，以此達成了整條音弧在上下劇烈顫動以及高架橋的視覺效果

物量計算

有的時候我們並不能玩到自製譜面，這個時候我們可以通過以下方式計算本譜物量：

  • 統計所有地面note和arctap數量，每統計一個+1
  • Hold物件逐個計算，每個hold被起始位置所在BPM的1/2拍（即8分音符，或(30000/BPM)毫秒）分成一個一個判定塊，每個判定塊開始處物量+1，每個Hold最後一個判定塊不加物量
    • BPM＞=255時，判定塊間隔變為所在BPM的1拍（即4分音符，或(60000/BPM)毫秒）
    • BPM=0時，本物件不存在，更無從談及物量
    • BPM＜0時，按BPM的絕對值進行計算
    • 當Hold長度短於本來的判定塊長度時，整個物件對半分為兩個判定塊，最後一個判定塊同樣不計入物量
    • 當Hold跨越timing時，按Hold起始點的BPM進行計算
    • 當存在TimingPointDensityFactor時，每個判定塊的時間需要除以TimingPointDensityFactor的值
  • Arc物件基本與Hold相同，注意每個arc語句單算
    • 持續時長為0的arc物量為0
    • skylineBoolean為true時物量為0
    • Arc可以連接形成Arc組，此時頭Arc按照Hold方式計算，其它Arc物量+1（存疑）
      • 連接條件：與Arc顏色無關，要求前一個Arc結尾和後一個Arc開頭x坐標差小於0.1，y坐標相等，時間差小於10
      • 即使不在同一timinggroup內也可以連成Arc組（具有noinput參數也可以）

需要指出，Hold和Arc可能會出現誤差，原因在於末尾處可能剛好超過計數點零點幾毫秒，不過即使如此正常情況下誤差總計也不會太大

還是一句老話，編完請你自己high，不要大規模傳播!!

注釋

  1. ↑ 只有愚人節版本（v2.0.2、v2.6.1、v3.5.3、v3.12.6、v4.4.2、v5.5.6、v5.5.8）可以正常讀取綠Arc，其他版本不能正常讀取綠Arc
  2. ↑ 此Arc在4.0.0版本中的顏色為灰色，可以正常判定，並且沒有換手限制；在5.5.6版本中，Arc顏色被更改為白色。
  3. ↑ 本功能在v1.7.0在代碼中被標記關閉，v1.8.0中相關代碼被徹底刪除，但在之後的愚人節版本（v2.0.2、v2.6.1、v3.5.3、v3.12.6）中被恢復，且v4.0.0版本後不再被刪除
  4. ↑ 此機制在2023年愚人節版本4.4.2過後不久刪除了部分代碼，導致無法正常讀取，在5.0.0版本中徹底從代碼中消失，直至2024年愚人節版本5.5.6又被重新添加回來
  5. ↑ Flick從3.5.3版本起被刪除了部分代碼，因此Flick不能在3.5.3版本之後正常讀取
取自 "https://arcwiki.mcd.blue/index.php?title=谱面格式&oldid=51025"