前提条件
- Horde Server および Horde Agent マシン（Windows）への管理者アクセス。
- Epic↔GitHub のリンクされたアカウントを通じた GitHub 上の UE ソース へのアクセス。 これは Horde 全般の要件であり、Horde のビルドステップではエンジンソースと UAT や UBT などのツールへのアクセスが必要になるためです。
1) Diversion をインストールしサインインする（Server + Agents）
- Horde Server と すべての Horde Agent で、Diversion for Windows インストーラーを実行します。
- Server と Agent の両方で Diversion を起動してサインインし、連携が UE5 ソースリポジトリに適切にアクセスできるようにします。
2) Diversion で UE5 ソースリポジトリを準備する（Windows）
2.1 UE ソースを Diversion にインポートする
Diversion での UE5 ソースリポジトリの準備は、現在クローズドプレビュー中の専用インポートツールで行います。このツールは、UE フォークをクローンし、Epic のSetup.bat を実行して、エンジンツリーを Diversion リポジトリにコミットするところまでを自動で行います。
インポートツールはまだ一般公開されていません。ツールと付属のセットアップ手順については、
support@diversion.dev までお問い合わせください。
2.2 このソースツリーに UE プロジェクト を追加する
このソースエンジンに対してコンパイルされるゲームプロジェクトを、想定されるパス（多くの場合、UE リポジトリのルート、または BuildGraph が想定する同階層のパス）に配置します。必要なファイルを Diversion にコミットします。3) Horde ストリームを Diversion リポジトリ/ブランチに向ける
これは、UE5 ソースリポジトリの準備（セクション 2）の 後 に行います。 Horde 設定ディレクトリ配下のストリーム設定（*.stream.json）を編集します:
C:\\ProgramData\\Epic\\Horde\\Server\\
name フィールドが Diversion リポジトリとブランチをターゲットにしていることを確認します:
構成が分割されている場合（globals → project → stream）、name は UE ソースストリームを表す stream JSON に配置してください。
4) UE ソースストリーム用に Horde を構成する
- Horde 設定ファイルが
C:\\ProgramData\\Epic\\Horde\\Server\\配下にあることを確認します。 - プロジェクト（
*.project.json）がストリーム（*.stream.json）を参照していることを確認します。 - ストリーム JSON で、Diversion リポジトリとブランチのマッピングを設定し（セクション 3 参照）、適切なジョブテンプレート（BuildGraph）とその他の Horde の一般要件を定義します。
- パイプラインが正しく設定されたことを検証するため、まずは最小限のエディター専用の BuildGraph ジョブから始めます。
Horde の設定スタックは Globals → Projects → Streams の順です。.project.json/.stream.json拡張子を使用することで、JSON スキーマツールを有効にできます。
5) スモークテスト
- 構成を保存した後、Horde を再起動またはホットリロードします。
- Horde ダッシュボードでプロジェクト/ストリームを開き、既存の構成に基づく小さな BuildGraph ジョブをキューに投入し、エージェントが Diversion から同期してビルドできることを確認します。
クイックリファレンス（Windows）
-
UE セットアップ
参考資料
- UE on GitHub — Epic↔GitHub アカウントの連携
- Download UE Source — 公式ガイド
- Build UE from Source — Windows 向けの注意事項
- Horde（概要） — 概要ドキュメント
- Horde Orientation — スキーマサーバー、構成
- Horde Build Automation（概要） — ビルド自動化の概要
- Horde Build Automation（チュートリアル） — ビルド自動化のチュートリアル