{%hackmd @penguin71630/theme %}

AstroDX 使用教學
===

<style>
.exp {
color: #FF7B7B;
font-weight: bold;
}
.mas {
color: #9F51DC;
font-weight: bold;
}
.remas {
color: #DBAAFF;
font-weight: bold;
}
</style>

<!-- ############################### -->

:::danger
更新：AstroDX 已經出官方教學了，請移步至官方 wiki：
https://wiki.astrodx.com/tw
:::

:::info
**GitHub：**
https://github.com/2394425147/maipaddx
:::

註：這篇文只包含 Andriod 上的安裝教學，目前 AstroDX 只支援 Andriod，針對 iOS 的版本還在開發中。等作者之後如果還有開多的公測名額就可以去搶搶看（目前名額都已經滿了）。


# 下載

到 `Code/Releases`(https://github.com/2394425147/maipaddx/releases?page=1)，選擇最新的版本，我寫這篇文的時候最新版本是 `v2.0.0.beta.pre.98.3`。點開 `Assets` 會看到一個附檔名是 `.apk` 的檔案，直接點一下下載就好。


下載完後到 `Downloads` 去點一下 apk 檔，安裝 AstroDX。



安裝完成後，點一下 APP 會進到這個介面。


點進去曲庫會到選歌介面，不過沒有裝任何譜面的話應該會是空的。

# 載入譜面

## 前置作業

要安裝譜面的話，就必須動到 `Andriod/data` 這個資料夾，但是 Andriod 11 之後系統會鎖住該資料夾的存取權限，必須下載第三方檔案管理 app。

試過很多 app 發現 [**File Manager Plus**](https://play.google.com/store/apps/details?id=com.alphainventor.filemanager&hl=zh_TW&gl=US) 或 **MT 管理器** 最好用，這裡以 File Manager Plus 為例，**請先到 Google Play 下載這個 app**。

下載完後，到資料夾 `Andriod/data/com.Reflektone.AstroDX/files`，中途 File Manager 可能會要求存取權，選擇同意就行。

:::danger
**2024.09.04 更新**：如果你的系統已經是 Android 13 或以上的版本，那麼任何檔案管理器（包含 File Manager Plus 和 MT 管理器）無法存取 `Andriod/data` 這個資料夾。

解決方法有二：
1. （很麻煩）Root 你的手機／平板
2. （強烈推薦）利用 Shizuku 讓 File Manager Plus 或 MT 管理器取得與 `adb` 同等級的權限：https://shizuku.rikka.app/zh-hant/introduction/
:::


**`levels` 資料夾是你放譜面的地方， `settings.json` 則是遊玩設定**（例如下落速度、音符樣式設定、判定顯示設定等等），其他不用管。

其實還有個方法，你可以直接拿一條 USB 線把平板／手機連到電腦，直接在電腦上操作就不會有權限問題。

## 譜面構成

一張可以被 AstroDX 讀取的譜面會由幾個部分構成：

:::info
:open_file_folder: com.Reflektone.AstroDX
├:page_facing_up: cache
├:page_facing_up: **settings.json**
├:open_file_folder: il2cpp
├:open_file_folder: Sentry
├:open_file_folder: **levels**
└──:open_file_folder: **某首歌的歌名**
$\quad \quad$├─:page_facing_up: 1. `bg.jpg`：該首歌的曲繪。
$\quad \quad$├─:page_facing_up: 2. `maidata.txt`：紀錄 maimai 的譜面資料。
$\quad \quad$├─:page_facing_up: 3. `track.mp3`：譜面的音檔。
$\quad \quad$└─:page_facing_up: 4. `pv.mp4`：背景播放的影片。
:::

其中 **maidata 跟音檔一定要有**，否則無法遊玩。即使沒有曲繪跟影片檔也可以遊玩。

如果你有很多首歌的話，levels 底下的資料夾允許有一層分類，像這樣：

:::info
:open_file_folder: **levels**
├─:open_file_folder: **類別 1**
$\quad \enspace$├:open_file_folder: 歌曲 1-1
$\quad \enspace$├:open_file_folder: 歌曲 1-2
$\quad \enspace$└:open_file_folder: 歌曲 1-3
└─:open_file_folder: **類別 2**
$\quad \enspace$├:open_file_folder: 歌曲 2-1
$\quad \enspace$├:open_file_folder: 歌曲 2-2
$\quad \enspace$└:open_file_folder: 歌曲 2-3
:::

接下來會以這張譜面為例：[**【maimai自制】一首歌的时间学会海底谭】（作者：墨滢-moying）**](https://www.bilibili.com/video/BV18v411u7MV/?share_source=copy_web&vd_source=ea566f79f87489557f0240ce764591c9&t=0)，講解如何安裝譜面。

方便起見，我已經把譜面資料上傳到 Google Drive，大家可以直接從這個連結下載就好：https://drive.google.com/drive/folders/19rfWBMLWqEb9VCNsUnRfqFrP6JBG6zJh?usp=sharing

## 下載譜面

由於 Google Drive App 不提供「下載資料夾的功能」，有點白癡，所以有兩個方法。

> **方法一**：在 `levels` 資料夾底下建一個新資料夾，名稱就直接命名為歌曲名。然後直接把 Google Drive 裡面的三個檔案 `bg.jpg`、`track.mp3`、`maidata.txt` 都下載到那個資料夾。

> **方法二**：上面那張譜的連結不要直接點擊，長按一下並選擇「在新分頁開啟」。接著在 Google 瀏覽器側邊選單勾選「電腦版網站」。
>
> 
>
> 點選歌曲資料夾的下拉選單，選擇「下載」，此時 Google Drive 會把整個資料夾打包成壓縮檔然後開始下載。
>
> 
>
> 下載完後解壓縮，把解壓縮後的資料夾複製到剛才提到的 `levels` 資料夾底下。

總之不管用哪種方法，弄好的資料夾看起來會像這樣：



回到 AstroDX，這時候應該就可以開始遊玩了！


結算畫面：


點一下 Details 可以看到詳細判定。


# 遊玩設定

選歌介面左上角有 :gear:，點一下可以進行遊玩設定。

右下角的 `Mods` 可以調整遊玩機制，包括 Autoplay、慢速遊玩、鏡像、扣血機制等等，詳細交給大家自己摸索。

稍微提一下，我覺得慢速遊玩是這個模擬器最棒的功能，非常適合用來拆配置、解手癖，由於 AstroDX 的慢速會連帶將歌曲的頻率降低，因此慢速的倍率我自己習慣按照十二平均律選擇：

| $(\sqrt[12]{2})^{-n}$ | 大約計算結果 |
|:---------------------:|:----------:|
| $n = 1$ | 0.94 |
| $n = 2$ | 0.89 |
| $n = 3$ | 0.84 |
| $n = 4$ | 0.79 |
| $n = 5$ | **0.75 (個人最常用)** |
| $n = 6$ | 0.71 |
| $n = 7$ | 0.67 |
| $n = 8$ | 0.63 |

# 譜面可以在哪裡下載

由於 SEGA 的遊玩政策，我不能直接貼官方譜面連結在這裡。但那些譜面可以在 AstroDX 的 Discord 群組找到。在 GitHub `Wiki/Finding levels` 最底下找到群組連結：https://github.com/2394425147/maipaddx/wiki/Finding-levels 。

<!-- 到頻道 `#scoreshare` 查看「已釘選的訊息」，就可以找到好心的大神們自己手抄的官方譜面。

想玩自製譜的話你可以翻翻其他頻道找找看，或是私訊作者本人能不能提供譜面。 -->

**一些提醒：**



# 其他

有任何問題請自己查閱 AstroDX 在 GitHub 上的 wiki：https://github.com/2394425147/maipaddx/wiki 。

另外如果想學習 maidata 語法、自己寫譜可參考這兩支影片：

[【maimai自制谱制作教程----基础版 音频剪辑&认识maidata】](https://www.bilibili.com/video/BV1av411y7cq/?share_source=copy_web&vd_source=ea566f79f87489557f0240ce764591c9&t=0)

[【maimai自制】majdata完全使用说明】](https://www.bilibili.com/video/BV15m4y1D7h1/?share_source=copy_web&vd_source=ea566f79f87489557f0240ce764591c9&t=0)

我是覺得學一下滿好用的，有時候在拆一張譜的時候會碰到自己不熟悉的配置，這時候可以透過修改譜面，把整張譜都改成那種配置之類的來練習。

我在拆 <span class="exp">credits 紅譜</span>的時候就是修改 maidata，把最後的怪節奏段複製到整張譜，然後開 0.75 倍速打個一兩次就把那段節奏記起來了。