Synth Ridersにカスタム曲を追加する方法 – Quest・PSVR2対応ガイド

1. 前提条件と概要

2. 必要なツールとインストール手順

2‑1. SideQuest の取得とセットアップ（H3）

1. 公式サイト https://sidequestvr.com/ から Windows／macOS 用インストーラをダウンロード。
2. インストーラを実行し、画面の指示に従ってインストール。
3. 初回起動時に「Android デバイスが検出されましたか？」と表示されたら USB ケーブルでヘッドセットを接続 してください（Quest は自動的に ADB ドライバーをインストールします）。

ポイント：SideQuest のインストールは約 3 分、以降のファイル転送やサイドロードアプリの管理に使用します。

2‑2. ADB（Android Debug Bridge）ドライバーの最新版導入（H3）

なぜ最新版が必要か：古いドライバーはデバイス認識エラーや転送失敗の原因になることがあります（Google の公式 FAQ 参照）。

2‑3. PC とヘッドセットの接続設定（H3）

Quest 系（Android デバッグ）

1. Meta アプリ → 「デバイス」→ 対象ヘッドセットを選択 → 開発者モード ON。
2. ヘッドセット装着後、設定 > システム > 開発者オプション で USB デバッグ を有効化。
3. PC に接続するとデバイスが「Ready」状態になることを SideQuest の左上インジケータで確認。

PSVR2（USB ストレージ機能）

1. PS5 本体の 設定 > システム > ストレージ を開く。
2. 「外部ストレージデバイスを使用できるようにする」または「USB デバイスを認識させる」を ON にします（画面表示は機種ごとに若干異なる）。
3. PSVR2 の USB‑C ケーブルで PC と接続すると、エクスプローラ上に PSVR2 というドライブが出現し、MTP (Media Transfer Protocol) モード が自動的に有効になります。

重要：PSVR2 には Android 系の「USB デバッグ」や開発者モードは存在せず、公式にサポートされているファイル転送手段は上記の MTP / 外部ストレージモード のみです。

3. カスタム曲のフォーマット要件

3‑1. JSON スキーマ（2024 年版）

Synth Riders は 2024 年リリースのアップデートで JSON ビートマップに新規必須項目を追加しました。公式ドキュメントは GitHub – synthriders/beatmap-schema に掲載されています[Schema Repo]。

必須フィールド（抜粋）

サンプル JSON
json
{
"songName": "MyCustomTrack",
"artist": "Author",
"bpm": 128,
"offset": 0.0,
"beatmapVersion": 2,
"audioFolder": "audio"
}

3‑2. 音源ファイルの推奨形式

MP3 はデコード時に遅延が発生しやすく、ゲーム内同期がずれることがあります。必ず .wav または .ogg を使用してください。

3‑3. フォルダ構造と命名規則

フォルダ例（共通）

• ファイル名は半角英数字・アンダースコアのみ。スペースや全角文字は認識エラーの原因になります。
• フォルダ階層は必ず Songs（Quest）または Music/SynthRiders（PSVR2）の直下に置くこと。

4. Quest 系デバイスへのカスタム曲追加手順

4‑1. SideQuest を使ったファイル転送（H3）

1. SideQuest 起動 → 左メニューの「Files」タブを選択。
2. ディレクトリパスに Android/data/com.synthriders/files/Songs と入力し、Enter キーで移動。
3. PC 上の <曲フォルダ> をドラッグ＆ドロップ。転送が完了すると 「Transfer complete」 の通知が表示されます。

ポイント：ファイルサイズが大きい場合は USB‑C 2.0/3.1 の高速ケーブルを使用し、転送中にヘッドセットの画面がロックされないようにしてください。

4‑2. ゲーム内で楽曲を有効化（H3）

1. Synth Riders を起動 → 「Options」 > 「Custom Songs」 メニューへ。
2. 新規追加した曲名が一覧に表示されたらスイッチを ON にします。
3. メインメニューの 「Playlists」 から曲を選択し、通常通りプレイできます。

注意：初回起動時はデータベース更新に数秒かかります。進行が止まっているように見える場合はしばらく待機してください。

5. PSVR2 へのカスタム曲追加手順

5‑1. PC からの USB（MTP）転送方法（H3）

補足：PSVR2 の MTP モードではファイルサイズが 4 GB を超える場合に転送失敗することがあります。大容量の音源は複数ファイルに分割して配置してください。

5‑2. ゲーム内で楽曲を有効化（H3）

1. Synth Riders → 「Settings」 > 「Custom Songs」 を開く。
2. 追加した曲が一覧に現れたらスイッチを ON にし、「Refresh List」 ボタンで再走査させます。
3. メインメニューの 「Playlists」 から選択してプレイ開始。

6. トラブルシューティング

6‑1. ログ確認方法（Quest）

SideQuest の 「Device」 タブから adb logcat を実行すると、Synth Riders 起動時のエラーログがリアルタイムで表示されます。JSON パースエラーやファイルアクセス失敗の原因特定に有用です。

6‑2. JSON スキーマエラー対策

• バージョン不一致：beatmapVersion が 2 でないと最新ビルドが読み込めません。
• 必須項目欠落：bpm, offset が無いと「Invalid Beatmap」エラーになるので、公式サンプルをベースに作成してください。

7. 楽曲の管理（追加・更新・削除）

ベストプラクティス：楽曲管理はフォルダ単位で行い、README.txt（自作）に曲のバージョンや作成日を記載すると後からのメンテナンスが楽になります。

8. 参考情報・リンク集

9. まとめ

1. Quest 系は開発者モードと USB デバッグを有効にし、SideQuest → ADB により /Songs フォルダへ JSON と音源を転送。
2. PSVR2は公式の「USB ストレージ機能」をオンにして MTP モードで PC から Music/SynthRiders 配下に同様のフォルダ構造をコピー。
3. 最新スキーマ（beatmapVersion: 2）と推奨音源形式（.wav/.ogg）を守れば、ゲームは自動的に楽曲を認識し、設定画面から有効化できる。
4. トラブル時はフォルダ構造・ファイル名・JSON の相対パスを最優先でチェックし、必要なら adb logcat でエラーログを確認する。

これらの手順に従えば、Meta Quest 系デバイスでも PSVR2 でも、数分でカスタム楽曲がプレイ可能になります。安全かつ合法的に自作やフリー素材を楽しんでください！