PCのValheimでMODをダウンロードしインストールする方法のガイド。MODマネージャーとWindows、Linux、macOSでの手動インストールの両方を扱う。
ValheimはUnity上で動作しており、MODはBepInExプラグインとして作られている。コミュニティは本家のBepInExをそのまま使うのではなく、独自ビルドを維持しており、それをまず理解しておく必要がある。
今回の例として使うのはEpicLootで、長年続いているルート・魔法アイテムのオーバーホールMODだ。実際の依存関係を引き込み、クライアントだけでなくサーバー側にもインストールする必要があるため、実例として最適だ。
必要なもの
- Windows 10以降、Linux、またはmacOSを搭載したPC。Valheimはこの3つすべてにネイティブビルドがある。
- Valheim、できればSteam版。理由は次のセクションで説明する。
- 数百MBの空き容量。EpicLootのような大規模なオーバーホールMODはさらに必要になる。
- 手動でインストールする場合は7-Zipなどのアーカイブツール。
- 始める前にワールドとキャラクターのバックアップを取ること。Windowsでは
%userprofile%\AppData\LocalLow\IronGate\Valheimに保存されている。
警告 - このバックアップは真剣に取っておくこと。EpicLootを含め、アイテムや進行要素を追加するMODはセーブデータに書き込みを行う。後でそうしたMODを削除すると、ゲームがもはや認識できないアイテムを持ったキャラクターが残ってしまうことがある。
所有しているValheimのバージョンが重要
ValheimはSteam、Microsoft Store、Xboxコンソールで販売されている。
- Steam版が、このガイドで前提としているバージョンであり、MODシーン全体が対象としているバージョンでもある。
- Microsoft StoreおよびGame Pass版は
C:\XboxGames\Valheim\Contentにインストールされ、MOD導入がはるかに困難だ。BepInExはゲームフォルダにファイルを書き込む必要があるが、これらのインストールはそれを妨げるような保護がかかっている。ここには公式にサポートされた方法は存在せず、MODマネージャーが動作することも期待すべきではない。 - Xboxコンソール版はMOD導入がまったくできない。クロスプレイによりXboxプレイヤーがPCサーバーに参加することはできるが、Xbox側のクライアントはバニラのままで、何も読み込むことはできない。
BepInExPack Valheim
BepInExPack Valheimはローダーであり、素のBepInExではない。これはAzumatt、Vapok、Margmasによって保守されているValheim専用ビルドで、事前設定済みのBepInEx.cfg、Linuxおよび専用サーバー向けの起動スクリプト、複数のMODが依存するプリローダーの変更、そして本家BepInEx 5では廃止されているセマンティックバージョンのサポートが含まれている。
汎用のBepInExではなく、このパックをインストールすること。
注記 - これはコミュニティによるフォークであるため、公式のBepInEx DiscordではValheimに関する問題のサポートを受けられず、その旨を伝えられるだけだ。Valheimの問題はValheim modding コミュニティに持ち込むこと。
BepInExに加えて、EpicLootは2つの共有ライブラリに依存している:
- Jötunn、ほとんどの本格的なMODが依存するValheim MOD開発ライブラリ。
- JsonDotNET、Newtonsoft.Jsonをパッケージ化したもの。
MODマネージャーはこの両方を自動的にインストールしてくれる。
Thunderstore MODマネージャーでインストールする
これが最も一般的な方法であり、MODページがリンクしている方法でもある。
Valheimに対応するマネージャーは3つあり、いずれも同じプロファイル形式を読み込む:
| マネージャー | 対応プラットフォーム |
|---|---|
| Gale | Windows, Linux |
| Thunderstore Mod Manager | Windows |
| r2modman | Windows, Linux, macOS |
どれを選んでも手順は同じだ:
- マネージャーをインストールしてValheimを選択する。
- プロファイルを作成する。
- EpicLootを閲覧または検索する。
- InstallまたはDownload with dependenciesをクリックする。BepInExPack Valheim、Jötunn、JsonDotNETが一緒についてくる。
- マネージャーからStart moddedまたは**Launch game (modded)**でゲームを起動する。
マネージャーは起動時にBepInExを組み込むため、Steamから直接Valheimを起動するとバニラのまま動作してしまう。
Vortexでインストールする
VortexはValheimに対応しており、ThunderstoreではなくNexus Modsから取得する。Nexus版のValheim MODカタログはずっと小規模で、ほとんどの作者はまずThunderstoreに公開するため、Vortexがすでに使い慣れたツールで、そこで目当てのものを見つけた場合に使うとよい。
- Vortexをインストールしてサインインします。
- Gamesの下でValheimを検索し、タイルにマウスを乗せてManageをクリックします。
- 下記の手動インストール手順を使ってBepInExPack Valheimを自分でインストールします。Vortexはローダーを自動でセットアップしてくれません。
- NexusからMod Manager DownloadでMODをダウンロードし、InstallとEnableを行います。
- 通常通りSteamから起動します。BepInExが導入済みであれば、Vortexはファイルをゲームフォルダに永続的に書き込むため、特別な起動方法は必要ありません。
警告 - Vortexとサンダーストア系のマネージャーを同じインストールに対して同時に使わないでください。両方がBepInEx/pluginsを管理したがるため、互いの作業を上書きしてしまいます。
手動でインストールする
まず、ゲームフォルダを見つける。SteamでValheimを右クリックし、管理、ローカルファイルを閲覧を選択する:
C:\Program Files (x86)\Steam\steamapps\common\Valheim
BepInExPack ValheimをManual Downloadでダウンロードし、ゲームフォルダ以外の場所に展開したうえで、BepInExPack_Valheimフォルダの中身をValheimフォルダに移動します。正しく行えば、valheim.exeの隣にBepInEx、winhttp.dll、doorstop_config.iniが並んでいるはずです。
次に、EpicLoot、Jötunn、JsonDotNETをダウンロードしてそれぞれ展開し、.dllファイルをValheim\BepInEx\pluginsにコピーします。
次に何をするかはプラットフォームによって異なります。
Windows
それ以外にやることはない。ゲームを起動すると、BepInExのコンソールウィンドウが一緒に表示されるはずだ。
Linux
- 起動スクリプトに実行権限を与える:
chmod u+x start_game_bepinex.sh
- Steamで、Valheimのプロパティを開き、起動オプションを次のように設定する:
./start_game_bepinex.sh %command%
- Steam経由で起動する。
相対パスの代わりにスクリプトのフルパスを指定することもできます。そうすれば、パックをゲームフォルダの外に完全に置いておくことができます。
macOS
ValheimにはネイティブのmacOSビルドがあるが、BepInEx 5はApple Siliconではネイティブに動作しない。これはMonoModに依存しており、MonoModがまだarm64に対応していないためだ。回避策は、ゲームをRosetta経由で強制的に実行することだ。
- スクリプトに実行権限を付与します:
chmod u+x start_game_bepinex.sh
- Valheimの Steam起動オプションを次のように設定する:
/usr/bin/arch -x86_64 /bin/bash ./start_game_bepinex.sh %command%
- Steam経由で起動する。
M系Macでarch -x86_64の部分を省略しても、ゲームは起動します。ただしBepInExなしで起動し、MODは一切読み込まれません。Intel Macではこの指定は不要です。
TMC Appでインストールする
ValheimはTMC Appがすでに対応しているゲームの1つであり、他の多くのガイドとは違い、これは単なる約束ではなく実際の選択肢だ。このアプリは私たち独自のMODマネージャー兼サーバーブラウザで、ここで扱う他の方法と同様にValheim MODをBepInEx/pluginsにデプロイする。
インストール方法:
- 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。
インストールが完了したら:
- アプリを開いてValheimを追加し、Steamのインストールフォルダを指定する。
- サンドボックスを作成する。サンドボックスは名前付きのMODプロファイルで、それぞれ独自のロード順序とデプロイ方法を持ち、切り替えても再ダウンロードは発生しない。
- そのサンドボックスに使いたいMODをインストールする。
- ゲームを起動する。
警告 - 頼る前にこの部分は読んでほしい。このアプリはまだ非常に初期の開発段階にあり、プレイの途中で気づかせるより、先に伝えておきたい。README自体、対応済みとされる全ゲーム(Valheimを含む)を「未検証」としており、Galeやr2modmanの代わりとしてではなく、それらと併用しながら試すものとして扱ってほしい。要件で触れたバックアップは必ず取っておくこと。
とはいえ、まさに今が試してみるのに最も有用な段階だ。うまく動作したなら、ぜひ教えてほしい。誤ったフォルダにデプロイされたり、ロード順が崩れたりした場合も、ぜひ本当に知らせてほしい。今の段階では、そうした報告がプロジェクトにとって何よりも価値がある。
このアプリはGPL-3.0の下でオープンソースとしてgithub.com/modcommunity/tmc-appで公開されている。バグ報告や機能要望はissueトラッカーへ、プルリクエストも歓迎する。Valheim側の改善に取り組みたい場合は、リポジトリにゲームごとのルールの仕組みが文書化されている。
サーバー側MODとマルチプレイ
ここはValheimプレイヤーがつまずきやすい部分で、他の多くの協力プレイゲームとは仕組みが異なる。
Valheim MODはおおむね3種類に分かれます:
- クライアントのみ。 UI調整、カメラ変更、見た目のMODなど。自分のマシンにインストールするだけで、他は何も気にしません。
- クライアントとサーバー両方。 アイテム、レシピ、クリーチャー、進行要素などを追加するもの全般。EpicLootはまさにここに該当し、専用サーバーにも各プレイヤーのクライアントにもインストールする必要があります。
- サーバーのみ。 管理ツール、バックアップ、ワールド管理など。
これを間違えると、たいてい接続時にバージョン不一致で切断されるか、サーバーがアイテムを認識できずにアイテムが消えるといった形で現れます。
専用サーバー用に、BepInExPack Valheimにはまさにこのためのstart_server_bepinex.shスクリプトが付属しています。chmod u+x start_server_bepinex.shで実行権限を付与し、Valheim自身のサーバースクリプトを編集するのと同じ方法で起動パラメータを編集し、start_server.shの代わりにこれを実行してください。
ゼロからサーバーを構築する場合は、別記事のValheimサーバー構築ガイドがその部分をカバーしています。
TIP - 管理型のValheimホスティングサービスの中には、トグル一つでBepInExをインストールしてくれるところもあります。シェルに触りたくないなら、それは正当な近道です。
MODの設定
MODは初回起動時に設定ファイルをここに書き込む:
Valheim\BepInEx\config
これらはプレーンテキストの.cfgファイルです。EpicLootは多くの調整項目をここに置いており、ルートテーブルや魔法効果用のJSONファイルもあります。デフォルトのままにせず調整したいなら、一度見ておく価値があります。
BepInEx Configuration Managerは、alt-tabせずに同じ値を編集できるゲーム内設定ウィンドウを追加します。Galeとr2modmanにもそれぞれ設定エディタが含まれています。
すべて正しく読み込まれたか確認する
Windowsでは、BepInExはゲームの隣にコンソールウィンドウを開く。タスクバーに表示され、起動シーケンスをそこで確認できる。
見るべきなのは灰色と白のテキストで、これは情報出力です。色が付いていたら注意が必要です:
| 色 | 意味 |
|---|---|
| 赤 | 致命的エラー |
| 濃い赤 | エラー |
| 黄 | 警告 |
| 濃いグレー | デバッグ出力 |
パック自体もコンソールに独自のThunderstoreバージョンを表示しますが、これは下層のBepInExバージョンとは別物です。
EpicLootに関しては、ワールドを読み込んでインベントリに魔法アイテムタブと強化ステーションのレシピがあるか確認してください。
アップデートとアンインストール
MODマネージャーは古くなったMODを検出し、クリック一つで更新できる。セーブデータに書き込むMODはバージョンが変わると挙動がおかしくなることがあるため、プレイの途中ではなくセッションの合間に更新を行うこと。
MODを削除するには、マネージャーでアンインストールするか、BepInEx/pluginsから.dllを削除します。バニラに戻すには、ゲームフォルダからBepInEx、winhttp.dll、doorstop_config.ini、起動スクリプトを削除してください。Steamはこれらをインストールしていないため、ファイル検証ではこれらを削除しません。
警告 - ワールドにアイテムを追加したMODを削除する前に、そのキャラクターとワールドをその後も使いたいかどうかを考えてください。バックアップはこのためにあります。
トラブルシューティング
BepInExのコンソールが表示されず、MODも読み込まれない。 Windowsでは、winhttp.dllがvalheim.exeの直下にあるか確認する。Linuxでは、起動オプションに./start_game_bepinex.sh %command%が含まれているか確認する。macOSでは、arch -x86_64のプレフィックスがあるか確認する。
バージョン不一致でサーバーから切断される。 あなたのMODとサーバーのMODが一致していません。サーバーが動かしているものと同じバージョンをインストールするか、ホストにMODリストの書き出しを頼んでください。
Valheimの更新後にMODが動かなくなった。 よくあることです。Iron Gateのパッチによってbepinex MODが壊れることがあり、作者側に時間が必要です。MODのThunderstoreページで更新版が出ていないか確認してください。
起動時にゲームがクラッシュする。 BepInEx/plugins の中身をすべて外に移動し、クリーンな状態で起動を確認したら、半分ずつMODを戻していって原因を特定してください。
シングルプレイでは動くのに、自分のサーバーでは動かない。 サーバーサイドMODは、ホストしているクライアントだけでなく、サーバー側にもインストールする必要があります。start_server_bepinex.sh を使用してください。
Microsoft Store版ではMOD化できない。 ほぼ不可能であり、公式にサポートされている回避策もありません。使うべきはSteam版です。
M系Macで何も読み込まれない。 起動オプションにRosettaのプレフィックスが抜けています。
結論
ほとんどの人向けの手短な答えはこうだ:Galeかr2modmanをインストールし、Valheimを選び、依存関係込みでEpicLootをインストールし、モデッド起動する。BepInExPack Valheimも一緒についてくるので、気にする必要はまったくない。
Valheim特有のことで覚えておく価値がある2点は、BepInExパックがコミュニティによるフォーク版であり、独自の癖と独自のサポート窓口を持っているということ、そしてアイテムや進行に関わるものは、クライアントだけでなくサーバー側にもインストールする必要があるということです。
Valheimは、私たち独自のTMC Appがすでに対応している数少ないゲームの一つです。オープンソースであり、開発の非常に初期段階にあるため、頼りにするというよりは試してみる価値があるものであり、フィードバックをいただければ本当にありがたいです。
See Also
- Valheim on Thunderstore
- Valheim on Nexus Mods
- Valheim Modding Discord
- Valheim Modding Wiki
- Official Valheim Modding FAQ - アセットバンドルシステムに関するIron Gate自身の解説で、Modがこれに対応する必要があります。
- Jötunn documentation
- TMC App
このガイドはできる限り最新の状態を保つよう努めていますが、Valheim、BepInEx、そしてMODライブラリはそれぞれ別々に更新されます。ここに書かれている手順が実際の状況と一致しなくなっている場合は、報告いただくか、このガイドのGitHubリポジトリでプルリクエストを作成してください。
質問がある場合や、modding関連で何かサポートが必要な場合は、Discordサーバーにご参加ください!

