> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# UE プラグイン - モジュールを読み込めない

> "Plugin 'Diversion' failed to load because module 'Diversion' could not be loaded"

プロジェクトを開いたときに Unreal Engine が次のエラーを表示する場合、エディターは Diversion プラグインを見つけたものの、そのコンパイル済みバイナリを読み込めていません:

> Plugin 'Diversion' failed to load because module 'Diversion' could not be loaded. There may be an operating system error or the module may not be properly set up.

これはプラグインの `Binaries` フォルダーに関するローカルの問題で、リポジトリや Diversion エージェントとは関係ありません。原因として次の 2 つが考えられます:

1. **バイナリが欠落している。** プラグインの `Binaries` フォルダーが空または不完全なため、エディターが読み込むモジュールがありません。
2. **バイナリが別の Unreal Engine バージョン向けにビルドされている。** すべてのプラグインバイナリは、実行中のエンジンと一致しなければならない `BuildId` を持っています。プラグインが別のエンジンバージョン向けにインストールされた、プラグインを再インストールせずにエンジンをアップグレードした、あるいはあるマシンでビルドされたプラグインバイナリが別のエンジンバージョンを実行するマシンにコピーされた場合、エディターはモジュールの読み込みを拒否します。

プラグインのインストール方法に合った修正方法を選んでください。

## プラグインを Fab からインストールした場合

プロジェクトが使用しているエンジンバージョンに、Fab ストアからプラグインを再インストールします。Launcher のライブラリからではなく、ストアの掲載ページから始めてください。ライブラリからのインストールだけでは、壊れたバイナリが確実に置き換わりません。この操作にプロジェクトを開く必要はありません。

**1. Fab ストアでプラグインを見つける**

Epic Games Launcher を開き、`Fab` タブに移動して `Diversion` を検索します。プラグインの掲載ページを開きます。

**2. 正しいエンジンバージョンにインストールする**

掲載ページで `Install to Engine` をクリックします。プロジェクトが使用しているエンジンバージョンを選択し (マイナーバージョンまで正確に一致させる必要があります)、`Install` をクリックします。

![エンジンバージョンを選択してインストール](https://mintcdn.com/diversion-2/tNxAwm8NrThaCp35/images/install-diversion-plugin.png?fit=max\&auto=format\&n=tNxAwm8NrThaCp35\&q=85\&s=e1c3355fd1be7605d8e9a87d33a5c84d)

**3. プロジェクトを再度開く**

プロジェクトをもう一度起動します。プラグインが読み込まれるはずです。

> [!NOTE]
>
> エンジンをアップグレードするたびにこの手順を繰り返してください。`UE_5.5` にインストールしたプラグインは `UE_5.6` では認識されません。

## プラグインがプロジェクトフォルダー内にある場合

プラグインがプロジェクトの `Plugins/Diversion/` フォルダーにある場合 (たとえば [ソースからビルドした](https://docs.diversion.dev/ja/unreal/unreal-engine-plugin.md#installing-the-plugin)、またはチームメイトがリポジトリにコミットした場合)、バイナリをお使いのエンジン向けに再ビルドする必要があります。

**1. 古いバイナリを削除する**

エディターを閉じてから、プロジェクト内の `Plugins/Diversion/Binaries/` フォルダーを削除します。`Plugins/Diversion/Intermediate/` が存在する場合は、それも削除します。

**2. プロジェクトを再度開く**

プロジェクトを起動します。Unreal Engine はバイナリの欠落を検出し、プラグインの再ビルドを提案するので、`Yes` をクリックします。これには C++ ツールチェーン (Windows では Visual Studio、Mac では Xcode) が必要です。

> [!NOTE]
>
> `Plugins/Diversion/Binaries/` と `Plugins/Diversion/Intermediate/` をリポジトリにコミットしないでください。ビルドされたバイナリは、それを生成したエンジンバージョンでのみ動作するため、マシン間で共有することがこのエラーのよくある原因です。代わりにこれらのフォルダーを [`.dvignore`](https://docs.diversion.dev/ja/basic/dvignore) に追加してください。

エラーが解消しない場合は、Diversion デスクトップアプリからサポートチケットを開くか、[`dv support`](https://docs.diversion.dev/ja/cmd-ref/support) を実行してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.