インストール
Locus は Unreal Engine のエディタ専用プラグインです。Fab からインストールするか、対応するプリコンパイル済みバイナリパッケージを選びます。
インストール前
Section titled “インストール前”- プロジェクトで使用する Unreal Engine のバージョンと完全に一致する Locus リリースを使ってください。別の Engine バージョン向けにビルドされたパッケージは読み込めないことがあります。
- Locus 1.1 は Unreal Engine 5.4～5.8 の Win64 ビルドをサポートします。macOS と Linux はリリース対象プラットフォームではありません。
Python Developer API は任意で、Unreal Engine 5.6 以降が必要です。検証済みの Unreal Engine リフレクション制限により UE 5.4 と 5.5 ではサポートされませんが、通常の Locus、C++、Blueprint、MCP はこれらのバージョンでもサポートされます。
Fab からインストールする
Section titled “Fab からインストールする”Fab または Epic Games Launcher からインストールする場合は、使用する Unreal Engine バージョン向けの Locus バージョンを選びます。プラグインファイルを手動でコピーする必要はありません。
- Unreal Editor で対象プロジェクトを開きます。
- Edit > Plugins を開き、まだ有効でなければ Locus を有効にします。
- 求められたら Unreal Editor を再起動します。
再起動後、Window > Locus、コンテンツブラウザのツールバーにある Locus ボタン、または Ctrl+Shift+L から Locus を開きます。
プリコンパイル済みバイナリパッケージを手動でインストールする
Section titled “プリコンパイル済みバイナリパッケージを手動でインストールする”手動配布の Locus パッケージには、対応する Unreal Engine バージョンに必要なプリコンパイル済みバイナリが含まれます。使用する Engine バージョンと完全に一致するパッケージを選んでください。
プラグインファイルをコピーまたは置き換える前に、Unreal Editor を閉じます。Locus プラグインのディレクトリ全体をコピーしてください。Binaries だけをコピーしたり、異なる Unreal Engine バージョン向けのパッケージのファイルを混在させたりしないでください。
プロジェクト固有のインストール
Section titled “プロジェクト固有のインストール”Locus プラグインのフォルダー全体を次の場所にコピーします。
<ProjectRoot>/Plugins/Locus/
存在しない場合はプロジェクトの Plugins ディレクトリを作成します。これにより Locus をそのプロジェクトで使用でき、プロジェクトごとに異なる Locus や Engine バージョンが必要な場合にもプラグインのバージョンを関連付けて管理できます。
Engine 全体へのインストール
Section titled “Engine 全体へのインストール”Locus プラグインのフォルダー全体を次の場所にコピーします。
<UnrealEngineRoot>/Engine/Plugins/Marketplace/Locus/
これにより、その Unreal Engine インストールで開くプロジェクトから Locus を利用でき、同じパッケージを各プロジェクトへコピーする必要がなくなります。他の Engine バージョンにはインストールされません。使用する各プロジェクトで Locus を個別に有効にしてください。
手動インストールを完了する
Section titled “手動インストールを完了する”- 対応する Unreal Engine バージョンでプロジェクトを再度開きます。
- Edit > Plugins で Locus を見つけ、まだ有効でなければ有効にします。
- 求められたら Unreal Editor を再起動します。
Window > Locus、コンテンツブラウザのツールバーにある Locus ボタン、または Ctrl+Shift+L から Locus を開きます。
公式に提供された対応済みのプリコンパイル済みバイナリパッケージでは、プロジェクトファイルの生成、Locus のコンパイル、プラグインの再ビルド、Visual Studio の起動、.Build.cs ファイルの変更は必要ありません。
使用時に作成されるデータの場所
Section titled “使用時に作成されるデータの場所”Locus は各コンテンツ種別を使った時点でストレージを作成します。
| コンテンツ | プロジェクトから見える場所 |
|---|---|
| 共有ノート | <Project>/ProjectNotes/ |
| 共有ピン | <Project>/ProjectPins/ |
| ドキュメント | <Project>/ProjectDocuments/ |
| プライベートなノートとピン、復旧、個人のプロジェクト UI 状態 | <Project>/Saved/Locus/ と <Project>/Saved/ 以下の関連する復旧フォルダー |
所有権と依存関係については、ノート、ピン、ドキュメント、プロジェクトへの影響と依存関係 を参照してください。
Locus を無効化または削除する
Section titled “Locus を無効化または削除する”プラグインを無効化または削除するとエディタ UI は停止しますが、上記の外部ファイルが意図的に削除されることはありません。プラグインをアンインストールする前にプロジェクトをバックアップし、残す Locus データをプロジェクトまたはソースコントロールリポジトリに保持するかどうかを別途決めてください。
Locus はエディタ専用モジュールで構成され、パッケージ化したゲームにランタイムシステムを追加しません。外部のノート、ピン、ドキュメントは UAsset ではなく、ゲームコンテンツとして自動的にクックされることもありません。削除後もワークスペースデータを残しておくことで、ゲームが Locus に依存することはありません。