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

於 2022年4月6日 (三) 09:05 的修訂

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

已確認。

技術型隱藏頁面索引

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

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

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

由259WA777撰寫的譜面解析

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

總論

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

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

理論上更改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(1～4):物件所在軌道，從左到右分別為1，2，3，4

Arc & 天空Note（Arctap）

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

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

t1,t2(ms)：Arc物件開始/結束的時間，數字為整數，t1可以等於t2，當t1=t2時，Arc與判定線平行，物量為0
- 只有skylineBoolean=true時t1可以大於t2
x1,x2：代表Arc物件開始/結束時的橫坐標，數字為不可省略小數點後兩位的一個數
easing(b,s,si,so)：Arc滑動方式。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：Arc顏色，0藍，1紅，2綠，在skylineBoolean=true時該參數無意義 ~~所以某些官方譜面含有skylineBoolean=true、color=3的Arc，而且不只一兩張~~
- 只有愚人節版本（v2.0.2、v2.6.1、v3.5.3、v3.12.6）可以正常讀取綠Arc，其他版本不能正常讀取綠Arc
FX(none,full,incremental)：目前尚未發掘出該參數的用途，已知本參數可以填none，full，incremental，可實際上填寫時並沒有區別 ~~lowiro模仿SDVX的證明(~~
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,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)：camera移動方式，qi=Cubic in，qo=Cubic out，l=Linear，s=Sine in&out
lastingtime(ms)：本語句持續時間

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

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值，範圍為0~255
  - 使用例：scenecontrol(20480,trackdisplay,6.00,0);
redline：Arcahv解鎖演出時的背景紅線效果
arcahvdistort：Arcahv解鎖演出時的背景變形效果
arcahvdebris：Arcahv解鎖演出時的背景碎片效果
- param1：本語句持續時間，數字為不可省略小數點後兩位的一個數，單位為秒
- param2：未知參數
  - 使用例：scenecontrol(40960,redline,1.88,0);
hidegroup：是否隱藏該時間組(timinggroup)內的note(由param2決定)
- param1：未知參數
- param2：
  - 1：隱藏該時間組的note
  - 0：顯示該時間組的note
    - 使用例：scenecontrol(81920,hidegroup,0.00,1);
- 需要放在時間組(timinggroup)中使用

Timinggroup

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

timinggroup(){
 //正常aff语句
};

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

如果需要用假note達成一些演出效果，可以在括號中加noinput參數：（v3.5.3新增）

timinggroup(noinput){
 //正常aff语句
};

此時本timinggroup內的物件只有顯示效果，沒有打擊判定和物量
noinput中的實體Arc在經過判定線後依然會消失而不會直接穿過（v3.12.6特性更改，在v3.12.6之前它們會直接穿過判定線）
noinput中的實體Arc保留了判定效果，因此依然可以實現一些正常的判定特性
- 如當異色Arc相交時，可以用任意一隻手去接/換手（v3.12.6的愚人節曲目 Mistempered Malignance 中的同色Arc段便是利用這個特性實現的，原理是在其中一條同色Arc上放了一條完全重疊的異色hidegroup Arc）

如果想做到Hold在未擊中狀態時漸變alpha的效果，可以在括號中添加fadingholds參數：（v3.12.2新增）

timinggroup(fadingholds){
 //正常aff语句
};

此時在未擊中Hold時，Hold會進行alpha漸變效果，直到變成未擊中時的alpha
此效果僅對timinggroup中的Hold生效，其他物件不受影響

Flick

代碼如下：

flick(t,x,y,vx,vy);

t(ms):Flick所在時間
x,y:Flick初始位置的橫、縱坐標，數字為不可省略小數點後兩位的一個數
vx,vy:Flick滑動方向向量的橫向、縱向值，數字為不可省略小數點後兩位的一個數，實際滑動方位角為正右方基礎上逆時針arctan(vy/vx)
官方譜面目前還沒有實裝過Flick，請謹慎使用Flick
v3.5.3開始的版本刪除了部分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)），超出Beyond難度梯形範圍可能會導致部分Arc或Arctap位於屏幕外
當Arc類型為黑線時，其沒有坐標界限（如 Dreamin' Attraction!! FTR的長方形隧道、Fracture Ray FTR的開頭倒數），但一般來說為了美觀都會將其放置在上述的梯形區間內
- 可能由於劇情或演出效果的需要，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，不要大規模傳播!!

@@ 行 16： / 行 16： @@
 ==总论==
- 谱面的后缀名为aff，所有官方谱面 在apk 安装包中并没有加密，可以直接阅读
+ 谱面的后缀名为aff，所有官方谱面 在 安装包中并没有加密，可以直接阅读
- 谱面所在位置为 （Android apk ）/assets/songs/<曲目id> 或 （iOS ipa ）/Payload/Arc-mobile.app/songs/<曲目id>里，其中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文件以及对应音源后重新正确封包即可游玩
@@ 行 83： / 行 83： @@
 **只有愚人节版本（v2.0.2、v2.6.1、v3.5.3、v3.12.6）可以正常读取绿Arc，其他版本不能正常读取绿Arc
 *'''FX'''(none,full,incremental)：目前尚未发掘出该参数的用途，已知本参数可以填none，full，incremental，可实际上填写时并没有区别 <s>lowiro模仿SDVX的证明(</s>
-*'''skylineBoolean'''(false,true)：判定这一段Arc是不是天空Note的判定线。false为普通Arc，true为天空Note的判定线，但是只要有Arctap本参数就无意义（会将此Arc的类型强制转换为 为黑 线）
+*'''skylineBoolean'''(false,true)：判定这一段Arc是不是天空Note的判定线 （黑线） 。false为普通Arc，true为天空Note的判定线，但是只要有Arctap本参数就无意义（会将此Arc的类型强制转换为 天空Note的判定 线）
 **当skylineBoolean=true，并且该Arc上有天空Note（Arctap）时，代码如下
@@ 行 122： / 行 122： @@
 :*trackshow：显示轨道
 :**不填参数
-:*trackdisplay：轨道透明度控制''（注意：此type并未在任何官方谱面中使用过，但是包含此type的sc语句可以正常被Arcaea本体读取并正确执行''（<s>高效率程序员看不惯单单是轨道显示/隐藏就写了两个type，于是造了个轮子（结果惨遭忽视））</s>）
+:***使用例：''scenecontrol(10240,trackhide);''
+:*trackdisplay：轨道透明度控制
+:**''（注意：此type并未在任何官方谱面中使用过，但是包含此type的sc语句可以正常被Arcaea本体读取并正确执行 ，'''请谨慎使用''' ''（<s>高效率程序员看不惯单单是轨道显示/隐藏就写了两个type，于是造了个轮子（结果惨遭忽视））</s>）
 :**param1：轨道从当前alpha变换到目标alpha(param2)所要花费的时间，数字为不可省略小数点后两位的一个数，单位为秒，填0.00等价于填1.00
 :**param2：轨道需要变换到的目标alpha值，范围为0~255
+:***使用例：''scenecontrol(20480,trackdisplay,6.00,0);''
 :*redline：Arcahv解锁演出时的背景红线效果
 :*arcahvdistort：Arcahv解锁演出时的背景变形效果
 :*arcahvdebris：Arcahv解锁演出时的背景碎片效果
-:**param1：本语句(大致的) 持续时间，数字为不可省略小数点后两位的一个数，单位为秒
+:**param1：本语句持续时间，数字为不可省略小数点后两位的一个数，单位为秒
 :**param2：未知参数
+:***使用例：''scenecontrol(40960,redline,1.88,0);''
 :*hidegroup：是否隐藏该时间组(timinggroup)内的note(由param2决定)
 :**param1：未知参数
@@ 行 135： / 行 139： @@
 :***1：隐藏该时间组的note
 :***0：显示该时间组的note
+:****使用例：''scenecontrol(81920,hidegroup,0.00,1);''
 :**需要放在时间组(timinggroup)中使用
@@ 行 145： / 行 150： @@
   };
-*每一个timinggroup语句块中的语句使用其内部单独的timing语句'''（并 需要 含 有 一 个Offset为0的timing ）'''，因此可以实现同时刻不同note流速 。
+*每一个timinggroup语句块中的语句 （物件） 使用其内部单独的timing语句'''（并 且至少包 含一 个timing语句 ）'''，因此可以实现同时刻不同note流速
-*timinggroup语句块中的timing语句不会产生小节线，小节线是由所有timinggroup语句块外面的timing语句决定的 。
+*timinggroup语句块中的timing语句不会产生小节线，小节线是由所有timinggroup语句块外面的timing语句决定的
-*一张谱面理论可以存在无限多个timinggroup语句块 。
+*一张谱面理论可以存在无限多个timinggroup语句块 ，也可以仅由t=0的timing和无数timinggroup组成
  如果需要用假note达成一些演出效果，可以在括号中加noinput参数：（v3.5.3新增）
@@ 行 156： / 行 161： @@
 *此时本timinggroup内的物件只有显示效果，没有打击判定和物量
-*noinput中的实体Arc在经过判定线后依然会消失而不会直接穿过
+*noinput中的实体Arc在经过判定线后依然会消失而不会直接穿过''（v3.12.6特性更改，在v3.12.6之前它们会直接穿过判定线）''
 *noinput中的实体Arc保留了判定效果，因此依然可以实现一些正常的判定特性
-**如当异色Arc相交时，可以用任意一只手去接/换手（v3.12.6的愚人节曲目 [[Mistempered Malignance]] 中的同 色蛇 段便是利用这个特性实现的，原理是在其中一条同 色蛇 上 叠 了一条完全 相同 的异色hidegroup 蛇 ）
+**如当异色Arc相交时，可以用任意一只手去接/换手（v3.12.6的愚人节曲目 [[Mistempered Malignance]] 中的同 色Arc 段便是利用这个特性实现的，原理是在其中一条同 色Arc 上 放 了一条完全 重叠 的异色hidegroup Arc ）
  如果想做到Hold在未击中状态时渐变alpha的效果，可以在括号中添加fadingholds参数：（v3.12.2新增）
@@ 行 167： / 行 172： @@
 *此时在未击中Hold时，Hold会进行alpha渐变效果，直到变成未击中时的alpha
+*此效果仅对timinggroup中的Hold生效，其他物件不受影响
+<!--如果想做到天空Note（ArcTap）不按时间轴方向，而是以特定角度方向前进，可以在括号中添加angle(x/y)(int)参数：（v3.12.6新增）-->
+<!-- timinggroup(anglex900){ -->
+<!--  //正常aff语句 -->
+<!-- } -->
+<!-- timinggroup(angley1800){ -->
+<!--  //正常aff语句 -->
+<!-- } -->
+<!-- *其中x/y代表天空Note（ArcTap）的 -->
+<!--待补充，欧拉角，参数间可用下划线连结，顺序不受影响，没有连接数量限制，偏移后判定位置不受影响 仅有视觉移动效果，y1800可代替-bpm的timing效果，angle仅影响天键 不影响黑线/实体Arc/其他任何tg内的物件-->
 ===Flick===
@@ 行 178： / 行 197： @@
 *'''vx,vy''':Flick滑动方向向量的横向、纵向值，'''数字为不可省略小数点后两位的一个数'''，实际滑动方位角为正右方基础上逆时针arctan(vy/vx)
 *'''官方谱面目前还没有实装过Flick，请谨慎使用Flick'''
-*v3.5.3开始的版本删除了部 分flick 代码，因此这些版本不能正常读取flick
+*v3.5.3开始的版本删除了部 分Flick 代码，因此这些版本不能正常读取flick
 ===综合===
-*代码排列顺序'''除了第一 个offset=0的Timing外'''不受限制。
+*代码排列顺序'''除了第一 个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)），超出Beyond难度梯形范围可能会导致部分Arc或Arctap位于屏幕外
 *当Arc类型为黑线时，其没有坐标界限（如 [[Dreamin' Attraction!!]] FTR的长方形隧道、[[Fracture Ray]] FTR的开头倒数），但一般来说为了美观都会将其放置在上述的梯形区间内
@@ 行 201： / 行 220： @@
 **持续时长为0的arc物量为0
 **skylineBoolean为true时物量为0
-**Arc可以连接形 成arc 组，此时 头蛇 按照Hold方式计算，其 它蛇 物量+1（存疑）
+**Arc可以连接形 成Arc 组，此时 头Arc 按照Hold方式计算，其 它Arc 物量+1（存疑）
-***连接条件： 与arc 颜色无关，要求前一 个arc 结尾和后一 个arc 开头x坐标差小于0.1，y坐标相等，时间差小于10
+***连接条件： 与Arc 颜色无关，要求前一 个Arc 结尾和后一 个Arc 开头x坐标差小于0.1，y坐标相等，时间差小于10
-***即使不在同一timinggroup内也可以连 成arc 组（具有noinput参数也可以）
+***即使不在同一timinggroup内也可以连 成Arc 组（具有noinput参数也可以）
-''需要指出，Hold和Arc可能会出现误差，原因在于末尾处可能刚好超过计数点零点几毫秒，不过即使如此正常情况下误差总计也不会太大 。''
+''需要指出，Hold和Arc可能会出现误差，原因在于末尾处可能刚好超过计数点零点几毫秒，不过即使如此正常情况下误差总计也不会太大''
-'''还是一句老话，编完请自己high 你 不要大规模传播!!!'''
+'''还是一句老话，编完请 你 自己high ， 不要大规模传播!!'''
 {{Usercheck-end}}