セットアップ

1必要なソフトウェア

以下をあらかじめインストールしておきます。すべてのコマンドラインツールは、コマンドプロンプトから呼び出せる状態（PATH が通っている）にしてください。

2OBS Studio 設定

本ツールは OBS Studio の録画ファイルと連携します。以下の 2 点を事前に設定してください。詳細は OBS Studio 公式サイト を参照してください。

1. 1
   シーンとソースの設定

   Fortnite の画面を録画するには、まず OBS でシーンを作成し、ソースを追加します。

   1. 「シーン」パネルの + ボタンで任意の名前のシーンを作成します。
   2. 「ソース」パネルの + ボタンをクリックし、ゲームキャプチャ を選択します。
   3. モードを 特定のウィンドウをキャプチャ に変更します。
   4. Fortnite を起動した状態でウィンドウのドロップダウンを開き、FortniteClient-Win64-Shipping.exe を選択します。

   💡

   Fortnite を先に起動しておく

   ドロップダウンに FortniteClient-Win64-Shipping.exe が表示されない場合は、Fortnite を起動してから再度ドロップダウンを開いてください。

   

2. 2
   リプレイバッファを有効化する

   Fortnite の画面を常時録画するため、「ファイル」→「設定」→「出力」→「リプレイバッファ」タブを開き、リプレイバッファを有効にする にチェックを入れてください。保存するリプレイの最大時間は試合の最大所要時間に合わせて設定します。（例: 1500 秒 = 25分）。Fortnite の試合は大体 25 分あれば十分です。
   これにより、好きなタイミングで Fortnite の画面の 25 分間の動画をキャプチャすることが出来ます。

   

3. 3
   WebSocket サーバーを有効化し、パスワードを取得する

   「ツール」→「WebSocket サーバー設定」を開き、WebSocket サーバーを有効にする にチェックを入れてください。

   「サーバーパスワードを有効にする」をオンにし、表示されたパスワードをコピーしておきます。このパスワードは後述の services/log_monitor_api/.env（OBS_PASSWORD 行）に貼り付けます。

   💡

   パスワードの確認方法

   「ツール」→「WebSocket サーバー設定」→「接続情報を表示」ボタンからいつでも確認できます。

   

3リポジトリの取得

任意の作業フォルダで以下を実行します。

git clone <repository-url> Fortnite_Replay_Util
cd Fortnite_Replay_Util\Integrated_App

以降の手順はすべて Integrated_App/ 直下で実行することを想定しています。

4Python 環境

1. 1
   仮想環境を作成

   powershell copy

   python -m venv ..\venv

   Integrated_App/ の 1 つ上に venv/ を作るのがプロジェクト規約です。

2. 2
   仮想環境を有効化

   powershell copy

   ..\venv\Scripts\Activate.ps1

3. 3
   依存パッケージをインストール

   powershell copy

   pip install -r services\requirements.txt

5フロントエンド

cd frontend
npm install
cd ..

npm install は初回のみ数分かかります。完了すると frontend/node_modules/ が作成されます。

6.NET パーサ

.replay のパースは C# の replay_parser サービスが担当します。初回起動時に自動ビルドされるため、ここでは依存物の確認だけ行います。

dotnet --list-sdks

一覧に 9.0.x が含まれていれば OK です。

7初期設定ファイル

設定は ~/.fortnite-suite/config.json に保存されます。初回はテンプレートを生成します。

python scripts\init_config.py

以下の 4 項目を実環境に合わせて編集してください。

8OBS パスワードの設定 (.env)

OBS WebSocket への接続情報は services/log_monitor_api/.env に保存します。config.json ではなく このファイルに設定する点に注意してください。

1. 1
   テンプレートをコピー

   powershell copy

   copy services\log_monitor_api\.env.example services\log_monitor_api\.env

2. 2
   OBS_PASSWORD を書き換える

   テキストエディタで services/log_monitor_api/.env を開き、OBS_PASSWORD= 行の右辺を Step 2-3 でコピーした実パスワードに置き換えます。

   env

   OBS_HOST=localhost
   OBS_PORT=4455
   OBS_PASSWORD=<OBS で取得した実パスワード>
   OBS_SAVE_DELAY=10

9セットアップ確認

1. 1
   全サービス起動

   powershell copy

   pwsh scripts\start.ps1

   6 サービス分の起動ログ（PID）が出れば OK。

2. 2
   疎通確認

   powershell copy

   python scripts\smoke.py

   全 6 行が OK で終了コード 0 なら成功。

3. 3
   フロント起動

   powershell copy

   cd frontend
   npm run dev

   ブラウザで http://localhost:5173 を開き、左サイドバーに 6 リンクが表示されていれば OK。