AstroDX をインストールする
AstroDX はコミュニティが開発した maimai 系シミュレーターです。本サイトが配布しているのは譜面だけで、アプリ本体は含みません。入手先はプラットフォームごとに異なるので、お使いの端末に合わせて進めてください。
- iOS / iPadOS：App Store から AstroDX をそのままインストールできます。公式が推奨する安定版です（TestFlight や IPA のサイドロードが必要という説明は古い情報です）。
- Android：GitHub Releases から最新の APK をダウンロードしてインストールします。「提供元不明のアプリ」の許可を求められるので、手動で許可してください。
譜面を入れる前に、必ず一度ゲームを起動しておいてください。AstroDX は初回起動時に自分用のフォルダを作るため、この手順を飛ばすと取り込んだ譜面の置き場所がありません。初回は曲が 1 つも入っていませんが、それが正常です。
- App Store — iOS / iPadOS の安定版（公式推奨）
- GitHub Releases — Android 向けの最新 APK
- AstroDX Wiki — 本ページが従っている公式ドキュメント
本サイトで譜面を探してダウンロードする
カタログでは曲名・アーティスト・別名（ローマ字も可）で検索でき、バージョン、ジャンル、譜面定数、BPM、収録リソースで絞り込めます。目的の譜面が見つかったら、詳細ページからダウンロードしてください。
ダウンロードボタン横のメニューで書庫形式を選べます。中身のファイルは 3 形式とも同じで、違いはコンテナだけです：
- .adx —— 推奨の AstroDX インポート形式。Android は「アプリで開く / 共有」で AstroDX に渡します。iOS は AstroDX フォルダ自体へ移動してからゲームを起動し直します。解凍は不要です。
- .zip —— 汎用の書庫。どの OS でも展開できるので、まず PC で整理したいときに向いています。
- .tar.gz —— コマンドラインでの作業や保管用です。.adx に名前を変えるだけでは取り込めません。ゲームに取り込む場合は .adx 形式でダウンロードしてください。
BGA 付きの譜面には背景動画（pv.mp4）が同梱されます。背景演出だけが変わり、判定には影響しません。「BGA 動画を含める」をオフにすると容量を減らせます。スマートフォンで 1 曲の容量が大きい場合は、BGA を外すかパソコンでダウンロードしてください。
- スマートフォンの一括ダウンロードは独立した小さなバッチに分かれます。ページを開いたまま、今回の作成完了を待ち、各ファイルの「ファイルを保存」を押してください。
- ブラウザーのダウンロード履歴で今回の全ファイルの保存完了を確認します。見つからない、または再試行が必要な場合は、解放を確認する前に「もう一度保存」を押してください。
- 「保存を確認してダウンロードを続行」で今回のキャッシュを解放し、次のバッチを開始します。最後は「保存を確認してキャッシュを解放」を押します。各ファイルを個別に保存・インポートしてください。解放後もインポート手順は表示されます。
ページ再読み込み後に取得済みデータから再作成できるのは、タスクやキャッシュをまだ削除していない場合だけです。解放後は同じデータをもう一度保存できません。選択した全曲の完了後は、トレイの「最近のダウンロード」から再取得できます。未完了の場合は残りのバッチを完了するか、曲を選び直してください。
ダウンロード回線は複数用意しています。速度が出ないときは設定パネルで既定の回線を切り替えるか、そのダウンロードだけ別のミラーを使ってください。
譜面を取り込む
AstroDX が取り込むのは .adx ファイル、つまり曲フォルダごと固めた zip の拡張子を変えただけのものです。本サイトの .adx はすでにその形なので、そのまま使えます。手元にあるのが .zip なら、拡張子を .adx に変えるだけで構いません（変更できない場合は「ファイル名.adx.zip」でも通ります）。
- iOS / iPadOS：ファイル App を開き、AstroDX のアイコンが付いた AstroDX フォルダに .adx を移動します。そのフォルダ自体に置くのがポイントで、中の levels や collections に入れてはいけません。
- Android：ファイルマネージャーで .adx をタップし、「アプリで開く」から AstroDX を選びます。一覧に出てこない場合は長押しして「共有」を選び、共有メニューから AstroDX を選んでください。
- PC でダウンロードした場合：展開は不要で、.adx をそのまま端末へ送ります。Mac なら AirDrop、Windows / Linux なら公式 Wiki が勧める LocalSend やケーブル、クラウドストレージなど。届いたら上記の手順に進みます。
そのあと AstroDX を開くと進捗バーが表示され、終わると選曲画面に新しい譜面が並びます。iOS では次にゲームを起動したときに自動で整理され、Android ではファイルを渡した時点で処理が始まります。
AstroDX フォルダ内の levels と collections はゲームが管理する領域です（levels は譜面ファイル、collections はコレクションごとの manifest.json）。手動で編集する方法は公式 Wiki にありますが、通常の取り込みでは触る必要はありません。
- 動画で見る譜面の入れ方 — bilibili の実演動画（中国語）
- Wiki · iOS / iPadOS の導入手順 — 公式のステップ解説
- Wiki · Android の導入手順 — 動画つき
よくあるトラブル
- ダウンロードが止まる・極端に遅いときは？
- 多くの場合、いま使っている回線とお使いのネットワークの相性の問題です。設定パネルの「ダウンロード」で速度を測り直し、遅延の小さい回線に切り替えてからやり直してください。中断したタスクはダウンロードトレイから再試行でき、完了済みのファイルは取り直しません。
- スマートフォンの一括ダウンロードが保存待ちで止まり、次のバッチが始まらない
- 今回の保存確認を待っています。全ファイルを保存し、ブラウザーのダウンロード履歴で完了を確認してから「保存を確認してダウンロードを続行」を押します。最後は「保存を確認してキャッシュを解放」を押してください。解放後は再保存できません。選択した全曲の完了後はトレイの「最近のダウンロード」から再取得でき、未完了の場合は残りを完了するか曲を選び直してください。ダウンロード中はページを開いたままにします。
- 保存を開始したのにファイルが見つからない、または .bin になった
- 保存開始の表示はブラウザーへの依頼を表し、端末への保存完了を保証するものではありません。ブラウザーのダウンロード履歴で完了を確認し、「ファイル」App やファイルマネージャーで探します。キャッシュ解放前は「もう一度保存」を使えます。.bin になった場合は保存を再試行するか .zip で取得し、インポート手順に従って変更してください。.bin をそのまま .adx に変更しないでください。解放後は全曲の完了後にトレイの「最近のダウンロード」から再取得し、未完了の場合は残りを完了するか曲を選び直します。
- 書庫が開けない・ファイルが壊れていると出る
- ブラウザーのダウンロード履歴で保存完了を確認してください。キャッシュ解放前は「もう一度保存」を優先し、それでも壊れている、または解放済みの場合は再取得します。.adx は手動解凍不要です。.zip は .adx または「ファイル名.adx.zip」に変更して取り込めます。.tar.gz は拡張子を変えるだけでは取り込めません。ゲーム用は .adx で取得し、保管用の解凍には TAR.GZ 対応ツールを使ってください。
- 取り込んだのに AstroDX に譜面が出てこない
- 多くは書庫を levels フォルダへ直接入れてしまったケースで、公式 Wiki でも「よくある間違い」として名指しされています。.adx は AstroDX フォルダ自体に置く（iOS）か、「アプリで開く / 共有」でアプリに渡して（Android）、展開はゲームに任せてください。インストール後に一度ゲームを起動したかも確認を。それでも出てこない場合はアプリを再起動してください。
- ファイルマネージャーに「アプリで開く」も「共有」もない（Android）
- 別のファイルマネージャーを使ってください。公式 Wiki は ZArchiver や Android SAF を挙げています。なお「IOException: Permission denied」が出る場合は、権限を昇格させたファイルマネージャーが譜面ファイルを書き換えて AstroDX から読めなくなっているのが原因で、上記の方法で入れ直せば解消します。
- iOS で拡張子が変更できない
- ファイル App の「その他」メニュー（…）→ 表示オプションで「すべてのファイル名拡張子を表示」をオンにしてから、ファイルを長押しして名前を変更します。どうしても無理なら「ファイル名.adx.zip」でも AstroDX は受け付けます。
- 音が出ない、ジャケットが真っ白
- 曲フォルダに track.mp3 か bg.png がありません。上流の譜面自体に音源やジャケットが付属しないことがあり、その場合は譜面詳細ページ上部のリソースバッジに表示されます。ページ上はあるのに手元に無い場合は、書庫をもう一度ダウンロードしてください。
解決しない場合は、曲名と症状を添えてご連絡ください：
- GitHub Issues — 本サイトの不具合・要望
- AstroDX アプリの Issues — ゲーム本体の不具合は上流リポジトリへ
- QQ グループ — 中国プレイヤー向けメイングループ
- Telegram グループ — 海外プレイヤーとサイトの最新情報