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 専用のインポート形式。スマホでタップするだけで取り込めるので、基本はこれを選んでください。
- .zip —— 汎用の書庫。どの OS でも展開できるので、まず PC で整理したいときに向いています。
- .tar.gz —— 同じく汎用の書庫で、容量は少し小さめ。コマンドラインでの作業やまとめて保管する用途に。
BGA 付きの譜面には背景アニメーション動画（pv.mp4）が同梱されます。プレイ中の背景演出が変わるだけで判定には影響しませんが、譜面本体の数倍の容量になることも多いため、一括ダウンロードでは「背景動画を含める」をオフにできます。
ダウンロード回線は複数用意しています。速度が出ないときは設定パネルで既定の回線を切り替えるか、そのダウンロードだけ別のミラーを使ってください。
譜面を取り込む
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 の導入手順 — 動画つき
よくあるトラブル
- ダウンロードが止まる・極端に遅いときは？
- 多くの場合、いま使っている回線とお使いのネットワークの相性の問題です。設定パネルの「ダウンロード」で速度を測り直し、遅延の小さい回線に切り替えてからやり直してください。中断したタスクはダウンロードトレイから再試行でき、完了済みのファイルは取り直しません。
- 書庫が開けない・ファイルが壊れていると出る
- まずダウンロードが最後まで終わっているか確認してください。途中で切れたファイルは展開できないので、削除して取り直します。iOS 標準の展開機能は一部の .tar.gz を正しく扱えないため、.zip を選ぶか、対応した解凍アプリをお使いください。
- 取り込んだのに 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 グループ — 海外プレイヤーとサイトの最新情報