PC版BONEWORKSでModをダウンロードしてインストールする方法のガイドです。
BONEWORKSはUnityで作られたVR専用の物理サンドボックスで、そのModはBepInExではなくMelonLoaderによって読み込まれます。これが、一般的にModが作られるUnityゲームとの主な違いです。すべてはThunderstore上にあります。
今回の実例として取り上げるのはCustom Mapsです。これはコミュニティ製のレベルをゲームに導入できるようにするマップローダーです。動作には他の2つのModが必要なので、スタック全体がどう組み合わさるかを示すのに良い例になります。
必要条件
- Windows 10以降を実行しているPC。ProtonによるLinuxでの動作は、追加の環境変数を設定すれば可能で、後述します。
- Steam版BONEWORKS、加えてVRヘッドセットとそのランタイム。フラットスクリーンモードはありません。
- Microsoft Visual C++ 2015-2019 Redistributable、64ビット版。MelonLoaderに必要です。
- .NET Desktop Runtime 6.0、x64版。BONEWORKSはIl2Cppゲームであり、MelonLoaderはこの種のゲームに対してこれを必要とします。
- 数百MBの空き容量、カスタムマップを集める場合はさらに多く。
BONEWORKSはアンチチートのないシングルプレイヤーゲームです。ここで紹介する内容でアカウントが危険にさらされることはありません。
BepInExではなくMelonLoader
Lethal CompanyやValheim、その他大半のUnityゲームでMod導入をしたことがあるなら、BepInExを使ったことがあるはずです。BONEWORKSはそれを使いません。
MelonLoaderはLavaGangによって作られた別の汎用Unity Modローダーで、この作品のようなIl2Cppゲームを第一級でサポートしています。基本原理は同じで、起動時にゲームをフックしてModを読み込みますが、フォルダ構成とインストーラーは独自のものです。
MelonLoaderのModは.dllファイルで、BepInEx/pluginsではなく、ゲームディレクトリ内のModsフォルダに配置されます。
ModThatIsNotMod
実際に導入したくなるBONEWORKSのModのほぼすべては、gnonme作のModThatIsNotModに依存しています。これはこのゲームの共有ライブラリであり、カスタムアイテムの読み込みを処理し、Mod作者にゲームのシステム向けのヘルパーを提供する、エコシステムの残り部分が構築される土台となっているものです。
Custom Mapsはこれに加えて、FieldInjectionも必要とします。したがって、今回の例における完全なスタックは以下のようになります。
MelonLoader -> ModThatIsNotMod + FieldInjection -> Custom Maps
Modマネージャーを使えば、それらすべてを自動的に処理してくれます。
BONELAB用Modについて一言
BONEWORKSとBONELABは別々のThunderstoreコミュニティを持つ別々のゲームですが、両方に掲載されているパッケージも存在します。この重複掲載は必ずしも意味のあるものとは限りません。
人々が最もよく遭遇するのがHitmarkersです。これはBONEWORKSの一覧に表示されますが、公開されているすべてのバージョンがBoneLibに依存しており、これはBONELAB用のライブラリでBONEWORKSには相当するものがなく、その説明文自体にもBONELAB向けに作り直されたと書かれています。ここでインストールしても、望む結果にはなりません。
経験則として、BONEWORKSのModが依存関係にModThatIsNotModを挙げているなら、それは正真正銘のBONEWORKS用Modです。BoneLibを挙げているなら、それはたまたま重複掲載されているBONELAB用Modです。
Galeでのインストール
Galeが最も簡単な方法で、MelonLoaderの導入もこちらで処理してくれます。
- ThunderstoreまたはGitHubからGaleをダウンロードします。
- 開いてBONEWORKSを選択します。
- Steamのインストール先を自動検出させるか、自分でゲームフォルダを指定します。
- Browse modsを開き、Custom Mapsを検索してInstallをクリックします。
- MelonLoader、ModThatIsNotMod、FieldInjectionが一緒にインストールされます。
- **Launch game (modded)**をクリックします。
SteamからBONEWORKSを起動するとMod無しで起動します。Galeから起動してください。
r2modmanでのインストール
r2modmanも同じように動作します。
- r2modmanをインストールし、BONEWORKSを選択します。
- プロファイルを作成します。
- Onlineを開き、Custom Mapsを検索し、Download with dependenciesを使用します。
- Start moddedをクリックします。
どちらでも問題ありません。Galeはより軽量で、r2modmanはより広範なプラットフォームをサポートしています。
自分でMelonLoaderをインストールする
マネージャーを使いたくない場合や、マネージャーで問題が発生した場合に知っておく価値があります。
まずゲームフォルダを見つけます。SteamでBONEWORKSを右クリックし、管理、続いてローカルファイルを閲覧を選びます。
C:\Program Files (x86)\Steam\steamapps\common\BONEWORKS
BONEWORKS.exeを探します。
自動インストーラー
これが推奨される方法で、実際とても簡単です。
- MelonLoader Installerをダウンロードします。
- 実行します。インストール済みのUnityゲームをスキャンし、自動的にBONEWORKSを一覧表示するはずです。表示されない場合は、Add Game Manuallyを使い、
BONEWORKS.exeを指定します。 - 一覧のBONEWORKSをクリックし、バージョンを選んでInstallを押します。
警告 - nightlyビルド用のスイッチには触らないでください。nightlyは最新のコミットから生成されるもので、頻繁に不具合を起こします。Modが対象とするのは安定版です。
手動インストール方法
- MelonLoader.x64.zipをダウンロードします。BONEWORKSは64ビットです。
- zip内の
MelonLoaderフォルダをBONEWORKSフォルダに展開します。 - 同じzip内の
version.dllもBONEWORKSフォルダに展開します。 - MelonLoaderがフォルダを生成するよう、一度ゲームを起動してから終了します。
これでBONEWORKS.exeと同じ場所に、MelonLoaderフォルダ、version.dll、Modsフォルダが揃っているはずです。
手動でModをインストールする
MelonLoaderが導入済みであれば、Modの導入は簡単です。
- Modの Thunderstore ページを開き、Manual Downloadをクリックします。
- zipを展開します。
.dllをBONEWORKSディレクトリ内のModsフォルダにコピーします。
Custom Mapsの場合、ModThatIsNotModとFieldInjectionも必要になるため、合計3つの個別ダウンロードが必要です。それぞれ、ModのDependenciesセクションに記載されているバージョンを取得し、各.dllをModsにコピーしてください。
一部のModは、.dllに加えてマップやモデルファイルなど、追加のコンテンツを同梱していることがあります。それらの配置場所についてはModの説明を確認してください。例えばCustom Mapsは、マップファイルをModsフォルダではなく、自身のフォルダから読み込みます。
注意 - Thunderstoreのzipに含まれるmanifest.json、icon.png、README.mdは、Webサイト用のパッケージングファイルです。Modsフォルダの中では何の役割も果たしません。
TMC Appでインストールする
最後に紹介するのは、私たち自身が開発しているツールです。TMC Appは、私たちが開発しているModマネージャー兼サーバーブラウザで、ワンクリックインストールとサンドボックス機能を備えています。サンドボックスとはゲームごとの名前付きModプロファイルで、それぞれが独自のロード順序とデプロイ方法を持ち、何もダウンロードし直すことなく切り替えられます。
BONEWORKSはまだサポート対象ゲーム一覧に入っていません。 ゲームの追加はJSONファイル4つで済み、コードを書く必要はないため、小さな作業です。そしてMelonLoaderを使うゲームは、まさにこのプラグインシステムが対象とすべき類のものです。
正直に言うと、このアプリは非常に初期の開発段階にあります。 READMEにもそう記載していますし、ここでも改めてそう述べておきます。多くの部分は部分的にしかテストされていないため、Galeの代わりとしてではなく、併用して試してみるくらいの気持ちで扱ってください。もし試してみたら、どうなったかぜひ教えてください。それが今、このプロジェクトにとって最も役立つことだからです。
このアプリはGPL-3.0の下でオープンソースとしてgithub.com/modcommunity/tmc-appに公開されています。バグ報告や機能要望はissueトラッカーへ、プルリクエストも歓迎です。自分でBONEWORKSサポートを追加したい場合のために、リポジトリにはゲームごとのフォーマットも文書化されています。
インストール方法:
- Linux:ワンライナーで完結し、rootもパッケージマネージャーも不要です。
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows:リリースページにある
setup.exeまたはsetup.msiを使用してください。ポータブル版もありますが、その場合ランチャーへの登録やtmc://リンクハンドラーの登録は行われません。 - macOS:同じリリースページにある
.dmgを使用してください。
動作確認
MelonLoaderは起動時にゲームと並んでコンソールウィンドウを開きます。起動処理中には自身のバージョンが表示され、続けて各Modを読み込むごとに、Mod名・バージョン・作者名が1行ずつ表示されます。
ログはディスクにも書き出されます:
BONEWORKS\MelonLoader\Latest.log
何かがうまくいかないとき、まず確認すべきなのはこのファイルであり、サポートを求める相手が最初に尋ねてくるのもこのファイルです。
Custom Mapsに関しては、マップファイルをインストールしていれば、ゲーム内でレベルを選択するための独自のUIがModによって追加されます。
Linuxでの実行
BONEWORKSはProtonを介して動作します。MelonLoaderを読み込ませるにはDLLオーバーライドが必要なので、ゲームのSteam起動オプションを次のように設定してください:
WINEDLLOVERRIDES="version=n,b" %command%
これはwinhttpではなくversionである点に注意してください。MelonLoaderはBepInExとは異なるフックDLLを使用しており、BepInEx用の起動オプションをそのまま使い回してしまうのはよくある間違いです。
手作業を避けたい場合は、MelonLoaderインストーラーにはLinux版ビルドも用意されています。GaleとR2modmanは、どちらも起動時にこのオーバーライドを自動で設定してくれます。
Modの削除
Modsフォルダから.dllを削除するか、Modマネージャー経由でアンインストールしてください。
MelonLoaderを完全に削除するには、ゲームディレクトリからMelonLoaderフォルダ、version.dll、Modsフォルダ、UserDataフォルダを削除してください。MelonLoader Installerにも、これを自動で行ってくれるアンインストールオプションがあります。
Steamのゲームファイルの整合性を確認する機能は、これらを一切クリーンアップしません。Steamは自身がインストールしていないファイルについては記録を持たないためです。
トラブルシューティング
コンソールウィンドウが表示されず、Modも読み込まれない。 MelonLoaderが読み込まれていません。version.dllがBONEWORKS.exeの直下にあること、そしてSteamからではなくModマネージャーから起動していることを確認してください。
MelonLoaderは読み込まれるが、あるModが読み込まれない。 MelonLoader\Latest.logを開いてください。依存関係の不足やバージョンの不一致は、どちらもここに明確に表示されます。
MelonLoaderが起動時にクラッシュする。 大抵は前提条件の不足が原因です。VC++ 2015-2019 x64再頒布可能パッケージと.NET Desktop Runtime 6.0 x64をインストールしてください。これらはIl2Cppゲームに必要です。
Modは問題なくインストールされたが、何も起きない。 それが本当にBONEWORKS用のModかどうか確認してください。依存関係リストにBoneLibが記載されている場合、それはたまたまクロスリストされているBONELAB用のModです。
ゲームアップデート後に全てが壊れた。 BONEWORKSは最近あまり頻繁にはアップデートされませんが、アップデートされた際にはMelonLoaderとModの両方が追従する必要があります。Modsフォルダを空にして、ゲーム本体自体が問題なく動くことを確認し、その上で待ちましょう。
Mod導入後にVRランタイムのエラーが発生する。 まずMod無しで起動し、ヘッドセット側が正常に動作しているか確認してください。Modの問題とSteamVRの問題は、ヘッドセットの中からだと見分けがつきにくいことがあります。
まとめ
BONEWORKSのModding(改造)は、BepInExではなくMelonLoaderであること、そしてModThatIsNotModが他の全てのModの土台となるライブラリであることさえ知っていれば簡単です。Galeをインストールし、使いたいModをインストールし、Gale経由で起動しましょう。
BONEWORKS特有の落とし穴は、クロスリストされたBONELABパッケージです。インストール前に依存関係リストを確認してください。ModThatIsNotModならBONEWORKS用、BoneLibならBONELAB用です。
何か力になりたいと思ったら、TMC Appはオープンソースかつ開発初期段階にあり、フィードバックは私たちにとって非常に価値のあるものです。
関連リンク
- BONEWORKS on Thunderstore
- MelonLoader Wiki - ローダー自体のドキュメントで、一読の価値があります。
- MelonLoader on GitHub
- BONEWORKS Modding Discord
- BONEWORKS Wiki
- TMC App
本ガイドはできる限り最新の状態を保つよう努めていますが、MelonLoaderやそれを基盤としたMODは時間とともに変化していきます。もし記載内容が実際の状況と異なっている場合は、報告いただくか、本ガイドのGitHubリポジトリでプルリクエストを作成してください。
質問がある場合や、MOD関連のことで手助けが欲しい場合は、Discordサーバーにご参加ください!

