PC版Hot Dogs, Horseshoes & Hand Grenades（H3VR）におけるModのダウンロードとインストール方法のガイドです。
H3VRはVR専用のサンドボックスシューターで、VR界隈でも最も長く続くModシーンの一つを持ち、その大半がThunderstoreに集まっています。ModはBepInExプラグインであり、みんなのお目当てである銃Modは、少数の共有ライブラリ群の上に成り立っています。
今回の例として使うのは、大型のモジュラーARパックであるMeats ModulARです。あえて単純なModではないものを選んでいます。H3VRの銃パックは単純であることが少なく、依存関係の連鎖こそ理解しておく価値があるからです。
必要条件
- Windows 10 以降を実行しているPC。Linuxでも Proton 経由で動作しますが、後述する追加の起動オプションが必要です。
- Steam版の H3VR。
- 動作するVRヘッドセットとランタイム。H3VRはSteamVRヘッドセットに加え、Oculusおよび Windows Mixed Reality デバイスにも対応しています。
- 数GBの空き容量。ガンパックは大量のモデル、テクスチャ、オーディオを含んでおり、本格的なH3VRのMODリストはすぐに肥大化します。
- 手動でインストールする場合は 7-Zip など同等のツール。
H3VRはシングルプレイでアンチチートも存在しないため、その点は心配無用です。
VR専用、フラットモードなし
最初にはっきり言っておく価値がある。H3VRはフラットスクリーンモードのないVR専用タイトルであり、MODを入れてもそれは変わりません。ヘッドセットを持っていない場合、以下の内容は一切関係ありません。
コンソール版も存在しないため、以下の内容はすべてPC限定です。
インストールされるもの
BepInEx
BepInExPack H3VR はローダーです。ゲームフォルダに配置され、起動時にゲームにフックし、BepInEx/plugins からプラグインを読み込みます。
汎用のBepInExではなく、H3VR専用パックを使用してください。バージョンは5.4.1700で固定されており、このゲーム向けに事前設定済みで、コミュニティもこれを前提にビルドしています。
OtherLoaderとその仲間たち
ここがH3VRが他の多くのBepInExゲームと異なる点です。ガンパックは実際には「コード」ではなく、アイテムの集合体であり、それらのアイテムをH3VRのスポーナーやプログレッションシステムに組み込むには共有のインフラが必要になります。
Meats ModulARは以下のいくつかに依存しています。
| 依存関係 | 役割 |
|---|---|
| OtherLoader | カスタムアイテムバンドルをゲームに読み込み、そのスポーナーへの登録を処理する。 |
| H3VRUtilities | 長年使われている共有ライブラリで、シーンの膨大な数のMODがこれに依存している。 |
| OpenScripts | MOD作者がカスタムパーツに付与する汎用の挙動スクリプト。 |
| FTW Arms AFCL | モジュラー武器MOD向けの共有アタッチメント・パーツライブラリ。 |
| Meats ModulARpt2 | このMOD自体の後半部分。Thunderstoreのパッケージサイズ制限のため分割されている。 |
これらすべてが互換性のあるバージョンで揃っていなければ、銃パックは何も機能しません。これこそが、ファイルを手動でダウンロードするのではなく、ここでModマネージャーを使うべき理由の全てです。
注記 - 大きなパックがpart 1とpart 2のパッケージに分割されているのは、H3VRのThunderstoreでは通常のことです。前半だけをインストールした場合、きれいなエラーではなく銃が欠けるという形で現れます。
r2modmanでのインストール
r2modman はH3VR向けの標準的な推奨手段で、ほとんどのMODページが前提としているツールです。
- Thunderstore または GitHubリリース からr2modmanをダウンロードする。
- 起動して H3VR を選択する。
- プロファイルを作成する。H3VRのMODリストがどれだけ巨大になるかを考えると、ロードアウトのテーマごとにプロファイルを分けるのは単に整理整頓というだけでなく本当に有用です。
- Online をクリックし、Meats ModulAR を検索して、Meat_banono による結果を開く。
- Download をクリックし、続けて Download with dependencies をクリックする。
- 待つ。これは数百MBを取得し、OtherLoader、H3VRUtilities、OpenScripts、FTWパーツライブラリ、ModulAR part 2を含みます。
- Installed タブを確認する。すべてが警告アイコンなしで表示されているはずです。
- Start modded をクリックする。
代わりにSteamからH3VRを起動すると、バニラ状態で起動してしまいます。Modはマネージャーが起動時にアタッチするため、起動はr2modmanから行う必要があります。
Thunderstore Mod Managerでのインストール
Thunderstore Mod Manager はr2modmanをベースにしており、Overwolfのラッパーの下で同じように動作します。
- インストールしてH3VRを選択します。
- プロファイルを選びます。
- Get modsをクリックし、Meats ModulARを見つけてDownloadをクリックします。
- 依存関係のリストを承諾します。
- Start moddedをクリックします。
どちらのマネージャーでも問題ありません。r2modmanはLinuxでより優れた選択肢であり、macOSビルドが存在する唯一のものですが、H3VR自体にはmacOS版はありません。
手動インストール
可能ではありますが、このようなMODにとっては本当に骨の折れる作業です。小さなMODで一度やってみるのは勉強になりますが、フルサイズのガンパックでこれをやるのは一晩を費やす価値のあることではありません。
SteamでH3VRを右クリックし、管理、ローカルファイルを閲覧からゲームフォルダを見つけます。
C:\Program Files (x86)\Steam\steamapps\common\H3VR
- BepInExPack H3VRをManual Downloadでダウンロードし、展開する。
BepInExPack_H3VRフォルダの中身をH3VRフォルダにコピーし、BepInEx、doorstop_config.ini、winhttp.dllがh3vr.exeと同じ場所に置かれるようにする。- 一度ゲームを起動して終了する。これにより
BepInEx/pluginsが作成される。 - Mod のThunderstoreページに記載されている依存関係を、指定された正確なバージョンで、さらにそれらが依存するものも含めてすべてダウンロードする。
- それぞれを展開し、
BepInEx/pluginsにコピーする。後で見分けられるよう、各Modを個別のサブフォルダに入れておくこと。 - Meats ModulARとModulAR part 2についても同様に行う。
警告 - 各Modはplugins配下でそれぞれ独自のフォルダに入れておくこと。H3VRのModは汎用的な名前のアセットバンドルを含んでおり、複数のパックを1つのフォルダにまとめてしまうと、互いに上書きし合う原因になりやすい。
ヒント - OtherLoaderはスキャンしたプラグインフォルダからアイテムバンドルを読み込む。ガンパックが正常にインストールされたのにスポナーに新しい銃が表示されない場合、手動インストールによるフォルダ構成の乱れがまず疑うべき点だ。
TMC Appでのインストール
もうひとつ、私たち自身のツールです。TMC App は私たちが開発しているMODマネージャー兼サーバーブラウザです。その サンドボックス はゲームごとの名前付きMODプロファイルで、それぞれ独自のロード順とデプロイ方法を持ち、切り替えても何も再ダウンロードされません。ロードアウトごとに別々のリストを保持し、しかもどのリストも読み込みに時間がかかるようなゲームにとって、これは明らかに魅力的な機能です。
H3VRはまだサポート対象ゲーム一覧に含まれていません。 ゲームを追加するにはコードではなく4つのJSONファイルを用意するだけなので、大した作業ではありません。
期待しすぎる前に言っておくと、このアプリは非常に初期の開発段階にあります。 READMEにもそう書かれていますし、私たちもそう言っておきます。多くの部分がまだ部分的にしかテストされておらず、H3VRのように依存関係の多いMODスタックに対しては、r2modmanが今も頼るべきツールです。ぜひ並行して試してみてください。試したら、その結果をぜひ教えてください。この段階では、早期のフィードバックほど私たちにとって価値のあるものはほとんどありません。
これはGPL-3.0の下でオープンソースとして github.com/modcommunity/tmc-app で公開されています。issueトラッカー ではバグ報告や機能要望を受け付けており、プルリクエストも歓迎です。H3VRのサポートを追加したい場合、リポジトリにはゲームの追加方法についてのドキュメントもあります。
インストール方法:
- Linux: 1行のコマンドで完結し、rootも不要、パッケージマネージャーも不要です。
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: リリースページ にある
setup.exeまたはsetup.msi。ポータブル版もありますが、ランチャーのエントリやtmc://リンクハンドラーは登録されません。 - macOS: 同じリリースページにある
.dmg。
ゲーム内でMOD武器を見つける
インストールした武器MODは何かを置き換えるわけではありません。バニラの武器庫と並んで表示されます。
任意のサンドボックスシーンに入り、Item Spawnerを開く。ModのガンはVanillaのものと同じカテゴリ一覧に表示され、多くの場合Mod独自のタグが付くか、作者の設定次第で別ページになる。Meats ModulARはモジュラーARレシーバーと大量のパーツを追加するため、銃器カテゴリとアタッチメントカテゴリの両方にエントリーが現れるはずだ。
Modを読み込んだ状態でゲームが起動するのにスポナーがバニラのままの場合、それはBepInExの問題ではなくOtherLoaderの問題であり、BepInExコンソールに通常その旨が表示される。
MODの長期的な管理
r2modmanは、Thunderstoreに新しいリリースがあるMODの横に更新バッジを表示し、Update all でまとめて対応できます。H3VRのガンパックは共有ライブラリに依存しているため、あるMODを更新すると、古いパックがビルドされた時点とは異なる新しいライブラリが引き込まれることがあります。大きな更新をまとめて行う前にプロファイルを複製しておくのは、安上がりな保険になります。
インストール済みリストでModを無効化してもファイルはそのまま残る。アンインストールすれば削除される。
完全にバニラへ戻すには、ゲームフォルダからBepInEx、doorstop_config.ini、winhttp.dllを削除する。Steamのファイル検証ではこれらは削除されない。Steamがインストールしたものではないためだ。
トラブルシューティング
MODなしでゲームが起動する。 Steamから起動してしまっています。Start modded を使ってください。
BepInExコンソールが出ない。 BepInExが読み込まれていない。winhttp.dllがh3vr.exeのすぐ隣にあるか確認すること。
Modは読み込まれるがスポナーに新しい銃がない。 OtherLoaderが欠けている、古い、またはアイテムバンドルが間違った場所にある。マネージャーから依存関係込みでModを再インストールすること。
読み込み時間が長い、カクつく。 ある程度のMod数を超えると普通に起こる。H3VRは起動時にすべてのアイテムバンドルを読み込むため、リストが大きいと実際に時間がかかる。全部を一度に動かすのではなく、プロファイルごとにModを分けると大幅に改善する。
テクスチャ欠落やピンク色のモデル。 たいていは半端にインストールされたパック、特にpart 2パックのスキップが原因。
ゲームアップデート後に起動時クラッシュ。 H3VRのアップデートはかなり大きな単位で行われ、Modが壊れることがある。BepInEx/pluginsを一時的に退避して確認し、作者の対応を待つこと。
LinuxとProton。 H3VRのSteam起動オプションをWINEDLLOVERRIDES="winhttp=n,b" %command%に設定する。r2modmanを通して起動する場合はこれを自動で処理してくれる。
まとめ
MODマネージャーに依存関係の解決を任せておけば、H3VRのMODインストールは簡単です。r2modmanをインストールし、H3VRを選択し、依存関係とともにダウンロードして、modded起動してください。
H3VR特有の注意点は2つ。ガンパックがスポナーに表示されるにはOtherLoaderとその仲間が必要なこと、そして大きなパックは複数のThunderstoreパッケージに分割されており、そのすべてをインストールする必要があることだ。
時間に余裕があれば、TMC App はオープンソースかつ開発初期段階にあるツールなので、そのフィードバックは本当にありがたいです。
関連リンク
- H3VR on Thunderstore
- H3VR Modding Wiki - 現在のコミュニティModding Wiki。
- H3VR Modding Discord
- Official H3VR Wiki - Modding専用ではなくゲーム全般のWikiだが、バニラ状態を確認するのに便利。
- TMC App
本ガイドはできる限り最新の状態を保つよう努めているが、H3VR、BepInEx、共有ライブラリはそれぞれ独立して更新されている。ここに書かれている手順が実際の状況と合わなくなっている場合は、報告するか、このガイドのGitHubリポジトリでpull requestを開いてほしい。
何か質問がある場合や、Modding関連で助けが必要な場合は、Discordサーバーにぜひ参加してほしい!