譜面格式

在您查看以下內容之前，我們需要您回答我們提供的問題。
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(四分音個數(拍))：表示每多少個四分音符(拍)為一小節（出現一條小節線），數字為小數，當bpm不為0時不可為0（為0代表每0個四分音符為1小節，會出現除零錯誤使遊戲崩潰）。比如4.00就是4/4拍，代表四拍一小節
  • 需要注意的是每個譜面一定要有一個t=0的Timing，並且其bpm數值要大於等於0，beats數值不為負數，才可被正常讀取。

地面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 & 天空音符（Arctap）

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

arc(t1,t2,x1,x2,easing,y1,y2,color,hitsound,arctype);

• 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綠，3白，在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」
• arctype(false,true,designant)：當填寫false/true時，判斷該Arc是否為音軌（黑線）。false為音弧（普通Arc），true為音軌，但是只要有Arctap且該值不為designant時會將此Arc的類型強制轉換為音軌；填寫designant時，該Arc表現為紅偏粉的音軌，且該Arc上的ArcTap也會被染色。請注意，designant類型的Arc上的ArcTap不會被記入總Combo數，擊打時也不會計入Combo和HP，且只會在Designant./Lament Rain異象時生效。
  • 當arctype=true，並且該Arc上有天空音符（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

• 於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 (string): qi, qo, reset (qi=Cubic in，qo=Cubic out，reset=重置Camera狀態，非上述三個值均為Linear)
• duration (ms): 語句持續時間

當ease不為reset時將關閉Arc對Camera的傾斜控制。

請注意，xyz軸移動的坐標並非與Arc位置坐標相同 (為世界坐標) 。Arc 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);
  • 當前版本使用trackhide/trackshow時等效於 scenecontrol(t,trackdisplay,1.00,0/255);

• trackdisplay：軌道透明度控制
  • 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和Désive）
  • 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);

• 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線移動至Arc坐標下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新增）：
  • 分別表示對timinggroup內的天鍵的軌跡進行旋轉，旋轉軸為經過天鍵在判定平面落點的平行於x/y軸的直線，其後需要接一個非負整數參數，表示旋轉角（單位：度）的10倍
    • 實際落點和判定位置不受影響
    • 此特殊效果僅影響天鍵，不影響地面tap/實體Arc/黑線
  • x軸旋轉時正方向為上轉，y軸旋轉時正方向為向左轉
  • 兩者可以疊加，疊加時先繞x軸平行線轉再繞y軸平行線轉，不受參數順序影響
    • 例：timinggroup(angley3400_anglex200)則會將所有天鍵的軌跡繞其對應的x軸平行線向上旋轉20°然後繞其對應的y軸平行線向右旋轉20°

Flick

代碼如下：

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，不要大規模傳播!!

注釋