# AstroDX

> AstroDX（前身为 MaipadDX）是一款maimai移动端模拟器，适用于那些无法游玩到机台，想要练习，以及所有对maimai感兴趣但无法游玩街机游戏的人。

# 下载 & 安装 AstroDX

## Android

[Releases · 2394425147/astrodx](https://github.com/2394425147/maipaddx/releases)

选择标有绿色latest字样的Release，下载Assets中的apk文件即可

> 出于稳定性的考量，不太推荐选择标有黄色Pre-release字样的版本进行使用

## iOS/iPadOS

首先，你需要在App Store中安装[TestFlight](https://apps.apple.com/cn/app/testflight/id899247664)

随后，从下方选择任意一个**仍有测试名额**的TestFlight组，加入测试组并安装AstroDX

[Join the AstroDX-Beta (Group A) beta](https://testflight.apple.com/join/rACTLjPL)

[Join the AstroDX-Beta (Group B) beta](https://testflight.apple.com/join/ocj3yptn)

[Join the AstroDX-Beta (Group C) beta](https://testflight.apple.com/join/CuMxZE2M)

[Join the AstroDX-Beta (Group D) beta](https://testflight.apple.com/join/T6qKfV6f)

[Join the AstroDX-Beta (Group E) beta](https://testflight.apple.com/join/sMm1MCYc)

由于每个测试组的测试名额有限，可能会遇到5个测试组全满的情况

无需担心，测试组会不定期自动清理不活跃的成员，时不时来看看，还是很好加入的！

> 如果想避免被清理出测试组，没事多打开TestFlight App看看就OK，有更新记得去更新一下，如果更新后发现兼容性问题也不必担心，TestFlight是允许降级应用的

由于测试组名额有限，请各位务必**不要重复加入测试组**！

# 获取谱面

## 获取单个谱面

[AstroDX谱面下载站](https://astrodx.milkbot.cn/)

根据网站提供的教程操作即可

## 获取所有谱面

https://cot.maimaidx.news/s/PkJhr/$BGANM$L

打开网页后，你会发现以下几个文件夹：

💠PRiSM PLUS: 直到maimai DX PRiSM PLUS的所有转谱（完整）

🥮CiRCLE: maimai DX CiRCLE首日更新的谱面

✨『Utage』〖宴〗: maimai FiNALE（旧框）的宴谱

💀〚Deleted Charts〛: 截止到maimai DX BUDDiES的所有删除曲

> 该数据源提供的删除曲数据很过时，一般不推荐使用（当然要是有想游玩删除曲的需求也不是不能用）

其他的文件夹不重要（也没有任何实质性内容），忽略即可

当然，如果有能力阅读README.md是极好的，因为本部分内容就是提炼自此README（如果看得懂就可以不用阅读本部分接下来的内容了）

首先，让我们下载PRiSM PLUS文件夹的内容

**[必须] **下载谱面

下载PRiSM_PLUS_maidata.7z

**[必须] **下载音乐

根据你的设备储存空间/性能情况来决定音频的音质（200Kbps/400Kbps）

在PRiSM_PLUS_Music_opus_200Kbps.7z和PRiSM_PLUS_Music_opus_400Kbps.7z中选择一个压缩包下载即可

**[必须] **下载曲绘

根据你的设备储存空间/性能情况来决定曲绘的品质（JPG/PNG）

在PRiSM_PLUS_Cover_JPG.7z和PRiSM_PLUS_Cover_PNG.7z中选择一个压缩包下载即可

[可选] 根据你的设备储存空间/性能情况来决定是否需要下载BGA（即游玩谱面时的背景视频）

需要BGA——下载7个名为PRiSM_PLUS_BGA_HEVC.7z的压缩文件（001-007）

不需要BGA——进入下一步

最后，根据你的需要决定是否下载旧框宴谱/删除曲

旧框宴谱位于✨『Utage』〖宴〗文件夹内的 Utage[宴]_NoBGA.7z，删除曲位于💀〚Deleted Charts〛文件夹

> 删除曲分有无BGA版，下载时请注意选择

所需文件下载完成后，接下来就需要进行组装了

### **组装谱面文件:**

> **解压密码：**💠PRiSM PLUS文件夹：舞萌 DX 2026

🥳✨[宴] Utage/🫠💀Deleted Songs文件夹：舞萌 DX 2023
如果你的解压软件无法输入/粘贴中文，请更换解压软件后再尝试

推荐使用7-Zip进行解压缩操作

首先，解压 PRiSM_PLUS_maidata.7z，你将会得到一个名为“PRiSM_PLUS_maidata”的文件夹**（后文简称****maidata文件夹****）**

其次，解压 PRiSM_PLUS_Music_opus_X00Kbps.7z （X指代你下载的压缩包名称），将里面的内容物移至**maidata文件夹**

解压 PRiSM_PLUS_Cover_XXX.7z（X指代你下载的压缩包名称），将里面的内容物移至**maidata文件夹**

[可选] 解压 PRiSM_PLUS_BGA_HEVC.7z.001，将里面的内容物移至**maidata文件夹**

> 什么，解压BGA文件时报错？

请确认你有没有完整下载001-007共七个分卷压缩文件，缺少任意一个都无法完成解压！

什么？六个文件都在？

请确认每个文件的大小，001-006均为4GB（或3.99GB），007为423.6MB，如果有某一文件的大小异常，请重新下载该文件

[可选] 解压 Utage[宴]_NoBGA.7z，将里面的“Utage[宴]_NoBGA”文件夹移至**maidata文件夹**

[可选] 解压 Songs_deleted开头的7z文件，将里面的内容物**（niconicoボーカロイド, POPSアニメ， ゲームバラエティ）**移至**maidata文件夹**

现在你的**maidata文件夹**里应该有以下内容:

maimai

niconicoボーカロイド

POPSアニメ

オンゲキCHUNITHM

ゲームバラエティ

宴会場

東方Project

Utage[宴]_NoBGA（如果你下载的话）

**至此，谱面文件已准备就绪**

# 导入谱面

## Android

### 官方教程（其实可以不看）

[安卓](https://wiki.astrodx.com/cn/install/android)

### 非官方教程（但是能看得懂）

> 由于Android系统的限制，**单个**.adx文件大小必须在**2 GB以内**

且创建的压缩文件为Level 1 (仅存储)级别，文件大小并不会因为压缩后变小

因此对于Android设备，我们需要再次进行文件封装

将之前在“获取谱面”章节中准备好的**maidata文件夹**里的每一个二级文件夹（maimai、niconicoボーカロイド...）压缩为zip文件

> 请全选**二级文件夹内**的**所有内容**

（比如我们需要压缩niconicoボーカロイド文件夹，正确的操作是打开niconicoボーカロイド文件夹，全选这个文件夹里的内容，右键创建压缩文件）

而**不是**直接右键**二级文件夹**创建压缩文件！！！

如果你这么做，会导致创建的压缩文件里多出一层文件夹

并且，在创建压缩文件时，请将压缩等级设置为"Level 1 (仅存储)"

![Image](https://upload.cafenono.com/image/slashpageHome/20250203/224208_rBTbA2ghU9DCP4o5Eb?q=80&s=1280x180&t=outside&f=webp)

处理好后的压缩包应该长这个样子：**（忽略文件夹的名字，只参考压缩包内的目录结构）**

![Image](https://upload.cafenono.com/image/slashpageHome/20250203/221132_nWUA6CdIyWYACFZEhE?q=80&s=1280x180&t=outside&f=webp)

接着，将zip文件的**后缀名**修改为adx（例如：niconicoボーカロイド.zip修改为niconicoボーカロイド.adx）

然后将该adx文件拷贝至你的Android设备，通过文件管理器点击它，选择使用AstroDX打开

此时AstroDX应该会自动开始导入曲目

## iOS/iPadOS

### 官方教程（其实可以不看）

[iOS/iPadOS](https://wiki.astrodx.com/cn/install/ios)

### 非官方教程（但是能看得懂）

首先，先琢磨出怎么把文件拷贝到你的iOS/iPadOS设备内

如果你使用的是Mac，请优先考虑使用AirDrop（隔空投送）

否则，请先在你的电脑上安装[iTunes](https://www.apple.com.cn/itunes/)或者[Apple Device](https://apps.microsoft.com/store/detail/apple-devices-preview/9NP83LWLPZ9K)

**（以下以iTunes为例）**

在安装好iTunes后，将你的设备连接至电脑，你将会在iTunes里看到它：

![Image](https://upload.cafenono.com/image/slashpageHome/20241030/222154_3W4Vnbjz2KCdtQnhZs?q=80&s=1280x180&t=outside&f=webp)

接下来，单击左侧的“文件共享”，选择"AstroDX"

![Image](https://upload.cafenono.com/image/slashpageHome/20241030/222532_1dTOiLq56myKttf8vE?q=80&s=1280x180&t=outside&f=webp)

将之前在“获取谱面”章节中准备好的**maidata文件夹**重命名为"levels"，并压缩为zip文件

> 请全选**maidata文件夹****内**的**所有内容**，右键创建压缩文件

而**不是**右键**maidata文件夹******创建压缩文件！！！

如果你这么做，会导致创建的压缩文件里多出一层文件夹

并且，在创建压缩文件时，请将压缩等级设置为"Level 1 (仅存储)"

![Image](https://upload.cafenono.com/image/slashpageHome/20250203/224208_rBTbA2ghU9DCP4o5Eb?q=80&s=1280x180&t=outside&f=webp)

处理好后的压缩包应该长这个样子：**（忽略文件夹的名字，只参考压缩包内的目录结构）**

![Image](https://upload.cafenono.com/image/slashpageHome/20250203/221132_nWUA6CdIyWYACFZEhE?q=80&s=1280x180&t=outside&f=webp)

接着，将zip文件的**后缀名**修改为adx（例如：levels.zip修改为levels.adx）

最后将该adx文件拖进iTunes中"'AstroDX'的文档“下方**空白处**，等待拷贝结束即可

# AstroDX 内设置

导入谱面后不要着急游玩！仍有一些关键设置需要调整

（当然我还是挺建议把整个设置菜单都逛一遍的）

点击主界面左上角的齿轮，前往”游戏“菜单，调整"Tap下落速度"和”Touch速度“

> 这里的数值与maimai DX实机的数值不对等，请自行进行测试后再调整

作为参考，我的上机流速为6.75，AstroDX内的流速为8.0

接着，来到”画质“菜单，关闭”降低帧率“，并将”质量等级“设定为”高画质“

> 除非帧率真的低到无法接受，否则非常不推荐设置为”高性能“

高性能会使得整个游戏变得非常模糊

尝试游玩一局，如果发现延迟问题，请前往设置里的”判定“菜单，调整”音频延迟“和”判定延迟“

如果游戏判定没有延迟问题但正解音有延迟问题，前往设置里的”音轨“菜单，调整”正解音延迟“

For the site tree, see the [root Markdown](https://slashpage.com/cczuyyb.md).
