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

於 2021年3月17日 (三) 14:25 的修訂

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

已確認。

技術型隱藏頁面索引

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

警告，這裏只是譜面格式的介紹帖，自製譜一切後果自負！

由於lowiro明確講過禁止傳播官方以外的版本，所以本頁面將保持孤立狀態，嚴禁鏈入/引用!

由259WA777撰寫的譜面解析

以下是在上述解析的基礎上編寫的。

總論

譜面的後綴名為aff，所有官方譜面在apk安裝包中並沒有加密，可以直接閱讀。

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

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

解析

文件頭

所有譜面開始都為以下兩行代碼

AudioOffset:x
-

這行代碼表示音樂整體往前(-)/往後(+)移動x毫秒
推薦x=0，這樣你物件對應的毫秒數即為歌曲對應的音的毫秒數。
但是如果x≠0，你的物件對應毫秒數應為(音對應的毫秒數+x)
鑑於有些音源以開頭為基準第一個采音不在整拍上，可能有時候你真的需要x≠0。~~懶得算了~~

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

AudioOffset:x
TimingPointDensityFactor:y
-

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

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

如果想更改關於解歌條件的部分，請移步解鎖條件(unlocks)格式

如果想更改曲包相關內容請移步曲包信息(packlist)格式

Timing

Timing代碼如下

timing(Offset,BPM,Beats);

Offset(ms):Timing起始位置，數字為整數
BPM(拍/分鐘):節奏速度，數字為不可省略小數點後兩位的一個數
Beats(四分音個數(拍)):表示每多少個四分音符(拍)為一小節（出現一條小節線），數字為不可省略小數點後兩位的一個數，比如4.00就是4/4拍，四拍一小節
- 需要注意的是一定有一個Offset=0的Timing！

地面Note & 地面Hold

地面Note & 地面Hold代碼如下

(t,lane);
hold(t1,t2,lane);

t(ms):地面Note所在時間，數字為整數
t1,t2(ms):地面Hold物件開始/結束的時間，數字為整數，t1＜t2
lane(1～4):物件所在軌道，從左到右分別為1,2,3,4

Arc & 天空Note

Arc & 天空Note代碼如下

arc(t1,t2,x1,x2,easing,y1,y2,color,FX,skylineBoolean);

t1,t2(ms)：虹弧Arc物件開始/結束的時間，數字為整數，t1可以等於t2，當t1=t2時，虹弧與判定線平行，物量為0。
x1,x2：代表Arc物件開始/結束時的橫坐標，數字為不可省略小數點後兩位的一個數
easing(b,s,si,so)：虹弧滑動方式。b=Both=Sine in & out，s=straight，si=Sine in，so=Sine out。當t1=t2時該參數無意義，都是直的
- si與so可以兩個在一起自由組合(如siso,sisi等)，siso代表x方向上滑動方式為si、y方向上滑動方式為so
y1,y2：代表Arc物件開始/結束時的縱坐標，數字為不可省略小數點後兩位的一個數
color：虹弧顏色，0藍，1紅，2綠，在skylineBoolean=true時該參數無意義 ~~所以某個官方譜面含有skylineBoolean值為true、color值為3的Arc~~
- 只有愚人節版本（v2.0.2、v2.6.1）可以正常讀取綠Arc，其他版本不能正常讀取綠Arc
FX(none,full,incremental)：目前尚未發掘出該參數的用途，已知本參數可以填none，full，incremental，可實際上填寫時並沒有區別 ~~lowiro模仿SDVX的證明(~~
skylineBoolean(false,true)：判定這一段虹弧是不是天空Note的判定線。false為普通虹弧，true為天空Note的判定線，但是只要有Arctap本參數就無意義，都為黑線
- 當skylineBoolean=true，並且該判定線上有天空Note時，代碼如下

arc(t1,t2,x1,x2,easing,y1,y2,color,FX,true)[arctap(tn1),arctap(tn2),……,arctap(tnm)];

tn1,tn2,……,tnm(ms):m個天空物件在這條判定線上的時間點，數字為整數，且不能超出t1和t2的區間

Camera

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

camera(t,transverse,bottomzoom,linezoom,steadyangle,topzoom,angle,easing,lastingtime);

t(ms):camera開始時間
transverse:軌道底部左右橫向移動,正←負→.
bottomzoom:軌道底部上下移動,正↓負↑
linezoom:判定線前後移動,正遠離負靠近
steadyangle(°):原地的攝像頭視角轉向,正逆時針負順時針
topzoom:軌道頂部的上下移動,正↓負↑
angle(°):底盤依照屏幕中心旋轉,正逆時針負順時針
easing(qi,qo,l,reset,s):cubicin,cubicout,line,reset,sinein&out
lastingtime(ms):本語句持續時間

本功能在1.7.0在代碼中被標記關閉，1.8.0中相關代碼被徹底刪除，但在之後的愚人節版本（v2.0.2、v2.6.1）中被恢復

Scenecontrol

於v2.6.1實裝（存疑），v3.0.0之前代碼如下：

scenecontrol(t,type);

t(ms):場景開始時間
type(trackhide,trackshow):是否展示軌道

v3.0.0更新的代碼如下：

scenecontrol(t,type,x,y);

t(ms): 場景開始時間
type:

trackdisplay: 展示軌道
redline: Arcahv解鎖表演時的背景紅線效果
arcahvdistort: Arcahv解鎖表演時的背景變形效果
arcahvdebris: Arcahv解鎖表演時的背景碎片效果

x(float): 未知參數
y(int): 未知參數

Timinggroup

代碼如下：

timinggroup(){
 //xxx
};

每一個timinggroup語句塊中的語句使用其內部單獨的timing語句（並需要含有一個Offset為0的timing），因此可以實現同時刻不同note流速。
timinggroup語句塊中的timing語句不會產生小節線。
一張譜面理論可以存在無限多個timinggroup語句塊。

物量計算

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

統計所有地面note和arctap以及flick數量，每統計一個+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進行計算
Arc物件基本與Hold相同，注意每個arc語句單算
- 持續時長為0的arc物量為0
- skylineBoolean為true時物量為0
- Arc可以連接形成arc組，此時頭蛇按照Hold方式計算，其它蛇物量+1（存疑）
  - 連接條件：與arc顏色無關，要求前一個arc結尾和後一個arc開頭x坐標差小於0.1，y坐標相等，時間差小於10

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

綜合

代碼排列順序除了第一個offset=0的Timing外不受限制。（存疑）

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

@@ 第17行： / 第17行： @@
  谱面的后缀名为aff，所有官方谱面在apk安装包中并没有加密，可以直接阅读。
- 谱面所在位置为\assets\songs\(歌 曲 文件名) 里，其中0,1,2,3分别对应PST,PRS,FTR及BYD。<s>其他的是什么东西自己打开便知道了</s>
+ 谱面所在位置为 （Android apk）\assets\songs\< 曲 目id> 或 （iOS ipa）\Payload\Arc-mobile.app\songs\<曲目id> 里，其中0,1,2,3分别对应PST,PRS,FTR及BYD。<s>其他的是什么东西自己打开便知道了</s>
  理论上更改aff文件以及对应音源后重新正确封包即可游玩。
@@ 第34行： / 第34行： @@
  有的谱面会在AudioOffset行下方加入一行TimingPointDensityFactor：
-  TimingPointDensityFactor:x
+ AudioOffset:x
+  TimingPointDensityFactor:y
+ -
- 这行代码表示音弧和长条的物量密度调整为正常值 的x 倍
+ 这行代码表示音弧和长条的物量密度调整为正常值 的y 倍
-<br>x=1时效果与省略此行相同
+<br>y=1时效果与省略此行相同
-<br><s>如 果x 的值特别大的话...</s>
+<br><s>如 果y 的值特别大的话...</s>
- 在该文件里并没有曲名 ， 谱师之类的歌曲信息，请移步[[歌曲信息(songlist)格式]]
+ 在该文件里并没有曲名 、难度等级、 谱师之类的歌曲信息，请移步[[歌曲信息(songlist)格式]]
  如果想更改关于解歌条件的部分，请移步[[解锁条件(unlocks)格式]]
@@ 第64行： / 第66行： @@
 *lane(1～4):物件所在轨道，从左到右分别为1,2,3,4
-=== 虹弧Arc & 天空Note===
+===Arc & 天空Note===
-虹弧Arc & 天空Note代码如下
+Arc & 天空Note代码如下
-  arc(t1,t2,x1,x2,slideeasing,y1,y2,color,FX,skylineBoolean);
+  arc(t1,t2,x1,x2,easing,y1,y2,color,FX,skylineBoolean);
-*t1,t2(ms): 虹弧Arc物件开始/结束的时间，数字为整数，'''t1可以等于t2'''，当t1=t2时，虹弧与判定线平行，物量为0。
+*'''t1,t2'''(ms) ： 虹弧Arc物件开始/结束的时间，数字为整数，'''t1可以等于t2'''，当t1=t2时，虹弧与判定线平行，物量为0。
-*x1,x2(-0.50～1.50): 代表Arc物件开始/结束时的横坐标，'''数字为不可省略小数点后两位的一个数'''
+*'''x1,x2'''： 代表Arc物件开始/结束时的横坐标，'''数字为不可省略小数点后两位的一个数'''
-*slideasing(b,s,si,so): 虹弧滑动方式。b=Both=Sine in & out，s=straight，si=Sine in，so=Sine out。'''当t1=t2时该参数无意义，都是直的'''
+*'''easing'''(b,s,si,so) ： 虹弧滑动方式。b=Both=Sine in & out，s=straight，si=Sine in，so=Sine out。'''当t1=t2时该参数无意义，都是直的'''
 **si与so可以两个在一起自由组合(如siso,sisi等)，siso代表x方向上滑动方式为si、y方向上滑动方式为so
-*y1,y2(0.00～1.00): 代表Arc物件开始/结束时的纵坐标，'''数字为不可省略小数点后两位的一个数'''
+*'''y1,y2'''： 代表Arc物件开始/结束时的纵坐标，'''数字为不可省略小数点后两位的一个数'''
-*color: 虹弧颜色，0蓝，1红，2绿，'''在skylineBoolean=true时该参数无意义'''
+*'''color'''： 虹弧颜色，0蓝，1红，2绿，'''在skylineBoolean=true时该参数无意义''' <s>所以某个官方谱面含有skylineBoolean值为true、color值为3的Arc</s>
-*FX(none,full,incremental): 目前尚未发掘出该参数的用途，已知本参数可以填none，full，incremental，可实际上填写时并没有区别 <s>lowiro模仿SDVX的证明(</s>
+**只有愚人节版本（v2.0.2、v2.6.1）可以正常读取绿Arc，其他版本不能正常读取绿Arc
-*skylineBoolean(false,true): 判定这一段虹弧是不是天空Note的判定线。false为普通虹弧，true为天空Note的判定线 。<s> 但是只要有Arctap本参数就无意义，都为黑线</s>
+*'''FX'''(none,full,incremental) ： 目前尚未发掘出该参数的用途，已知本参数可以填none，full，incremental，可实际上填写时并没有区别 <s>lowiro模仿SDVX的证明(</s>
+*'''skylineBoolean'''(false,true) ： 判定这一段虹弧是不是天空Note的判定线。false为普通虹弧，true为天空Note的判定线 ， 但是只要有Arctap本参数就无意义，都为黑线
 **当skylineBoolean=true，并且该判定线上有天空Note时，代码如下
-  arc(t1,t2,x1,x2,slidemethod,y1,y2,color,FX,true)[arctap(tn1),arctap(tn2),……,arctap(tnm)];
+  arc(t1,t2,x1,x2,easing,y1,y2,color,FX,true)[arctap(tn1),arctap(tn2),……,arctap(tnm)];
 *tn1,tn2,……,tnm(ms):m个天空物件在这条判定线上的时间点，数字为整数，且不能超出t1和t2的区间
-=== 综合===
+===Camera===
-代码排列顺序'''除了第一个offset=0的Timing外'''不受限制。
-'''还是一句老话 ， 编完请自己high你不要大规模传播!!!'''
+*于v1.6.1实装 ， 代码如下：
-===1.6.1新特性===
+ camera(t,transverse,bottomzoom,linezoom,steadyangle,topzoom,angle,easing,lastingtime);
-*arc语句中，x1 x2 y1 y2参数可以超出限制<!--谁用更早版本的arcaea测试一 下 超出限制能不能读取谱面-->
+*'''t'''(ms):camera开始时间
-* 新增camera语句
+*'''transverse''':轨道底部左右横向移动,正←负→.
-** 位置在第一个Timing语句 下 方，''' 不混杂在真正note语句里''' ，按 时 间 顺 序排列，用一个空行与真正note 语句 分开
+*'''bottomzoom''':轨道底部上 下 移动,正↓负↑
+*'''linezoom''':判定线前后移动,正远离负靠近
+*'''steadyangle'''(°):原地的摄像头视角转向,正逆时针负顺时针
+*'''topzoom''':轨道顶部的上 下 移动,正↓负↑
+*'''angle'''(°):底盘依照屏幕中心旋转,正逆 时 针负 顺 时针
+*'''easing'''(qi,qo,l,reset,s):cubicin,cubicout,line,reset,sinein&out
+*'''lastingtime'''(ms):本 语句 持续时间
-  camera(t,transverse,bottomzoom,linezoom,steadyangle,topzoom,angle,easing,lastingtime);
+  本功能在1.7.0在代码中被标记关闭，1.8.0中相关代码被彻底删除，但在之后的愚人节版本（v2.0.2、v2.6.1）中被恢复
-::*t(ms):camera开始时间
+===Scenecontrol===
-::*transverse:轨道底部左右横向移动,正←负→.
-::*bottomzoom:轨道底部上下移动,正↓负↑
-::*linezoom:判定线前后移动,正远离负靠近
-::*steadyangle(°):原地的摄像头视角转向,正逆时针负顺时针
-::*topzoom:轨道顶部的上下移动,正↓负↑
-::*angle(°):底盘依照屏幕中心旋转,正逆时针负顺时针
-::*easing(qi,qo,l,reset,s):cubicin,cubicout,line,reset,sinein&out
-::*lastingtime(ms):本语句持续时间
-:*本功能在1.7.0在代码中被标记关闭，1.8.0中相关代码被彻底删除，但在之后的愚人节版本中被恢复
-===2.0.2新特性===
+于v2.6.1实装（存疑），v3.0.0之前代码如下：
-*camera回来了, 添加s转换属性
+ scenecontrol(t,type);
-*添加绿arc，color值为2，并且只有愚人节版本才能读取绿arc
-===2.6.1新特性===
+:*'''t'''(ms):场景开始时间
+:*'''type'''(trackhide,trackshow):是否展示轨道
-*camera和绿arc回来了
+v3.0.0更 新 的代码如下：
-* 新 增scenecontrol语句
-  scenecontrol(t,type);
+  scenecontrol(t,type,x,y);
-:*t(ms):场景开始时间
+*'''t'''(ms):  场景开始时间
-:*type(trackhide,trackshow): 是否 展示轨道
+*'''type''':
+:*trackdisplay:  展示轨道
+:*redline: Arcahv解锁表演时的背景红线效果
+:*arcahvdistort: Arcahv解锁表演时的背景变形效果
+:*arcahvdebris: Arcahv解锁表演时的背景碎片效果
+*'''x'''(float): 未知参数
+*'''y'''(int): 未知参数
-===3.0.0新特性===
+===Timinggroup===
-*新增timinggroup语句块
+代码如下：
   timinggroup(){
@@ 第129行： / 第133行： @@
   };
-:*每一个timinggroup语句块中的语句使用其内部单独的timing语句，因此可以实现同时刻不同note流速。
+*每一个timinggroup语句块中的语句使用其内部单独的timing语句'''（并需要含有一个Offset为0的timing）''' ，因此可以实现同时刻不同note流速。
-:*timinggroup语句块中的timing语句不会产生小节线。
+*timinggroup语句块中的timing语句不会产生小节线。
-:*一张谱面理论可以存在无限多个timinggroup语句块。
+*一张谱面理论可以存在无限多个timinggroup语句块。
-*scenecontrol语句修改参数
- scenecontrol(t,type,x,y);
-:*t(ms): 场景开始时间
-:*type:
-::*trackdisplay: 展示轨道
-::*redline: Arcahv解锁表演时的背景红线效果
-::*arcahvdistort: Arcahv解锁表演时的背景变形效果
-::*arcahvdebris: Arcahv解锁表演时的背景碎片效果
-:*x(float): 未知参数
-:*y(int): 未知参数
 ==物量计算==
@@ 第150行： / 第141行： @@
 *统计所有地面note和arctap以及flick数量，每统计一个+1
-*Hold物件逐个计算，每个hold被起始位置所在BPM 的osu 1/4 拍( 也就是SDVX的1/16小节)[说明：即判断间隔 毫秒 数是60000/bpm/2] 分成一个一个判定块，'''每个判定块开始处物量+1''' 。
+*Hold物件逐个计算，每个hold被起始位置所在BPM 的1/2 拍 （即8分音符，或(30000/BPM)毫秒 ） 分成一个一个判定块，'''每个判定块开始处物量+1'''，每个Hold最后一个判定块不加物量
-**特殊的 ，每个Hold最后一个判定块不加物量
+**BPM＞=255时，判定块间隔变为所在BPM 的1 拍 （即4分音符，或(60000/BPM) 毫秒）
-**BPM＞=255时，判定块间隔变为所在BPM 的osu 1/2 拍( 也就是SDVX的1/8小节)
 **BPM=0时，'''本物件不存在'''，更无从谈及物量
 **BPM＜0时，按BPM的绝对值进行计算
-**当Hold长度短于本来的判定块长度时，整个物件对半分为两个判定块('''无论如何 最后一个判定块不计入物量''')
+**当Hold长度短于本来的判定块长度时，整个物件对半分为两个判定块 ， 最后一个判定块 同样 不计入物量
 **当Hold跨越timing时，按Hold起始点的BPM进行计算
 *Arc物件基本与Hold相同，'''注意每个arc语句单算'''
 **持续时长为0的arc物量为0
 **skylineBoolean为true时物量为0
-**Arc可以连接形成arc组，此时头蛇按照Hold方式计算，其它蛇物量+1
+**Arc可以连接形成arc组，此时头蛇按照Hold方式计算，其它蛇物量+1 （存疑）
 ***连接条件：与arc颜色无关，要求前一个arc结尾和后一个arc开头x坐标差小于0.1，y坐标相等，时间差小于10
 ''需要指出，Hold和Arc可能会出现误差，原因在于末尾处可能刚好超过计数点零点几毫秒，不过即使如此正常情况下误差总计也不会太大。''
+===综合===
+代码排列顺序'''除了第一个offset=0的Timing外'''不受限制。（存疑）
+'''还是一句老话，编完请自己high你不要大规模传播!!!'''
 {{Usercheck-end}}