Contents
1️⃣ 前提条件と環境設定
| 必要項目 | 確認方法 |
|---|---|
| 公式版 BONELAB がインストール | Meta Quest Store → 「購入済み」かつ「インストール済み」をチェック |
| 開発者モード有効化 | スマホに Meta Developer Hub(旧 Oculus アプリ)を入れ、デバイス設定で「開発者モード」を ON |
| SideQuest (Android) の導入 | Google Play → 「SideQuest」アプリをインストールし、USB または Wi‑Fi で Quest と接続 |
開発者モードの有効化手順(スマートフォン)
- Meta Developer Hub を起動し、Meta アカウントでログイン
- 左上メニュー → 「デバイス」 → 使用中の Quest 2/Quest Pro を選択
- 「開発者モード」を ON にし、指示があれば本体を再起動
SideQuest のセットアップ(Android 版)
| 手順 | 内容 |
|---|---|
| インストール | Google Play → SideQuest を検索・ダウンロード |
| デバイス認識 | Wi‑Fi 接続の場合は Quest の「設定」→「開発者」→「Wi‑Fi ADB」を有効にし、同じネットワークに接続。USB 接続でも OK(ケーブルが必要) |
| 権限付与 | 初回起動時に表示される「USB デバッグ許可」「ファイル転送」などのダイアログはすべて承認 |
ポイント:PC がなくても Android 版 SideQuest と開発者モードだけで、Quest 本体へ安全にファイルを転送できます。
2️⃣ 必要な MOD ローダーの取得
| コンポーネント | ダウンロード先(直接リンク) |
|---|---|
| MelonLoader (Quest ビルド) | https://github.com/LemonLoader/MelonLoader/releases/latest (「Quest Build」アセットを選択) |
| Bonelab Mod Loader (BML) | https://github.com/bonelab-modloader/BML/releases/latest (BML_quest.zip を取得) |
| 参考情報(Reddit) | https://www.reddit.com/r/BONELAB/comments/1rm554w/how_to_install_melonloader_and_code_mods_without/ |
ダウンロードのポイント
- MelonLoader:
MelonLoader_quest.zipにinstall.shと Android 用.apkが同梱されています。 - BML:
BML_quest.zipには Loader 本体とサンプル MOD が入っています。
注意:ZIP 内のスクリプトは直接実行せず、SideQuest の「ローカルファイルからインストール」機能でサイドロードしてください。
3️⃣ Quest へサイドロードする手順
3‑1. SideQuest(Android)を使う方法
- SideQuest アプリを起動 → 左上の 「+」 → 「ローカルファイルからインストール」 を選択
MelonLoader_quest.zipを指定し、続けてBML_quest.zipを指定- インストール完了の通知が出たら、Quest の設定 > アプリ一覧に 「MelonLoader」 が表示されることを確認
3‑2. Quest 内蔵ブラウザで直接ダウンロードする方法
- Quest のブラウザで上記 GitHub リリースページへアクセス
- 「Download ZIP」ボタンをタップし、ファイルが
Downloadsフォルダーに保存されるのを待つ - 通知バーから 「インストール」 を選択 → 自動的にサイドロードが開始
両方法とも、インストール後は Quest の設定 > アプリとゲームで Loader が有効になっていることを必ず確認してください。
4️⃣ MOD ファイルの配置場所と有効化
正しいフォルダー構成(実機上のパス)
|
1 2 3 4 5 |
/sdcard/Android/data/com.stresslab.bonelab/files/mods/ │─ MyMod.dll ← コード MOD(DLL) │─ texture_pack.zip ← アセット MOD(ZIP) └─ README.txt ← 任意の説明ファイル |
- フォルダー作成:SideQuest の「ファイルマネージャ」→
/sdcard/Android/data/com.stresslab.bonelab/files/にmodsが無い場合は 新規作成 - 転送手段:SideQuest、または Android 端末のファイルマネージャ(例:FX File Explorer)で同フォルダーにコピー
ゲーム起動時の確認ポイント
- Quest のライブラリから 『BONELAB』 を起動
- 起動画面左上に 「MelonLoader」 と 「BML」 のロゴが表示されれば Loader が正常に読み込まれています
- ゲーム内メニュー → 「Mod Settings」 でインストールした MOD が一覧に出ているかチェック(チェックボックスで有効/無効を切替可)
5️⃣ おすすめ MOD の取得先と安全チェック
| 配布元 | URL |
|---|---|
| mod.io – BONELAB | https://mod.io/g/bonelab |
| Nexus Mods – BONELAB | https://www.nexusmods.com/bonelab |
- 公式が許可したものかどうかは、各ページの「Verified」バッジや作者情報で確認してください。
- 配布元が不明な ZIP ファイルは 絶対にインストールしない(マルウェア感染リスク)。
法的注意
- クラック版・非公式 APK の使用は Meta の利用規約違反です。
- MOD は必ず公式ストア版(
com.stresslab.bonelab)でのみ動作させましょう。
6️⃣ トラブルシューティングと安全対策
6‑1. MOD が読み込まれないときの基本フロー
| 手順 | 内容 |
|---|---|
| ① ログ確認 | SideQuest → .../files/logs/MelonLoader.log をダウンロードし、エラーメッセージを検索 |
| ② 再インストール | SideQuest で「MelonLoader」→「アンインストール」後、再度 ZIP をインストール |
| ③ キャッシュクリア | Quest 設定 → 「ストレージ」→「キャッシュされたデータ」から BONELAB と MelonLoader のキャッシュを削除 |
| ④ MOD バージョン確認 | 使用している MOD が Loader のバージョンと合っているか公式ページで再チェック |
6‑2. よくあるエラーメッセージ例
| エラー | 原因例 | 対策 |
|---|---|---|
Failed to load assembly MyMod.dll |
DLL が Android 用にビルドされていない | Windows/Linux 上で Unity → IL2CPP で再コンパイル(開発者向け) |
Missing dependency: Newtonsoft.Json |
必要なライブラリが同梱されていない | MOD の配布ページで「依存ファイル」欄を確認し、併せて導入 |
Permission denied (Write access) |
/mods/ フォルダーの権限不足 |
SideQuest でフォルダー権限を 755 に変更(「chmod」コマンドは不要) |
7️⃣ 最終チェックリスト
| 項目 | 確認方法 |
|---|---|
| 公式版使用 | Meta Store → 購入済み・インストール済みか |
| 開発者モード有効 | Meta Developer Hub のデバイス設定で ON |
| MOD 配布元の正当性 | mod.io、Nexus Mods など公式ページから取得 |
| 空き容量 ≥ 200 MB | Quest 設定 → ストレージで確認 |
| バックアップ実施 | mods フォルダー全体を別ディレクトリにコピー |
この項目がすべてクリアできれば、PC なしでも安全に『BONELAB』の MOD 環境が構築できます。
8️⃣ 次のステップとコミュニティ参加
- 好きな MOD を組み合わせる
-
新しい武器・マップ・ビジュアルエフェクトなど、実験的な組み合わせで自分だけのラボを作り上げましょう。
-
情報共有は Discord が最速
- 公式 BONELAB Discord: https://discord.gg/bonelab(招待リンク)
-
質問や最新 MOD の紹介は「#mod‑support」チャンネルへ投稿してください。
-
定期的なアップデートの確認
- MelonLoader と BML は頻繁に更新されます。GitHub のリリースページを週1回チェックすると、互換性トラブルを未然に防げます。
まとめ
- 開発者モード+SideQuest(Android)だけで PC 不要 の MOD 環境が完成
- 正しいパスは
com.stresslab.bonelab→/sdcard/Android/data/com.stresslab.bonelab/files/mods/ - 公式リポジトリと信頼できる配布元からファイルを取得し、ログ確認・再インストールで多くの問題は解決
さあ、Quest の実験ラボに自分だけのカスタムコンテンツを注ぎ込みましょう! 🎮🚀