Unreal Engine プラグイン

インストール

uVersion プラグインはプリコンパイル済みバイナリとして配布され、desktop クライアントが管理します。 コンパイル作業は不要で、ソースファイルを扱う必要もありません。

サポートされる Unreal バージョン：5.6 以降。

手順

1. uVersion desktop クライアントをインストールします
2. Unreal プロジェクトを含むワークスペースをクライアントに追加します
3. Unreal パネルがあなたの .uproject を自動的に検出します
4. クライアントが、お使いの Unreal バージョンとプラットフォームに対応したプラグインをインストールします
5. Unreal でプロジェクトを開くと、プラグインはすぐに有効になります

アップデート

desktop クライアントは、プロジェクトを開いたときと 6 時間ごとに新しいバージョンを確認します。 お使いの Unreal に対してより新しいバージョンが利用可能になると、クライアントの Unreal パネルに 「Update ready」バッジが表示されます。Unreal エディタを閉じてから それをクリックしてアップデートを適用してください（プラグインは読み込まれている間は置き換えられません）。

初回接続

Unreal エディタで：Tools → Source Control → Connect to Source Control と進み、 Provider ドロップダウンで uVersion を選択します。

認証情報は desktop クライアントから自動的に取得されます。再入力する必要は一切ありません。 何らかの理由で desktop クライアントがインストールされていない場合、エディタは サーバーアドレスと認証情報を入力するフォームを表示します。

プラグインが Unreal で行うこと

ネイティブ Source Control

checkout、checkin、revert、history：すべて Content Browser の右クリックメニューから利用でき、 他の Unreal Source Control Provider とまったく同じように使えます。 アーティストが新たに覚えることは何もありません。

編集時の自動ロック

アセットを変更すると、プラグインが手動の checkout なしに自動的にサーバー側のロックを取得します。 あなたは作業に集中し、プラグインが裏側でロックを処理します。

ビジュアルな Blueprint 差分

Blueprint の 2 つのリビジョンを、エディタ標準のビジュアル差分ツールを使って Unreal 内で直接比較できます。 履歴上のどのコミットに対しても機能します。

checkin 前の検証

送信のたびに、プラグインは変更されたファイルに対して一連のチェックを実行します： Blueprint のコンパイル、命名規則、テクスチャサイズ、欠落した依存関係、 循環依存など。エラーは checkin をブロックし、警告は注意として表示されます。 ルールは desktop クライアントの Admin パネルからプロジェクトごとに有効化・設定できます。

redirector のクリーンアップ

アセットをリネームまたは移動すると、Unreal は蓄積しがちな redirector を生成します。 プラグインは checkin 時にそれらを自動的に検出してクリーンアップし、 影響を受けるすべてのアセットの参照を更新します。

起動時の照合

プロジェクトを開くと、プラグインはアセットの状態を確認し、ステータスをサーバーと同期します。 編集中だったファイルは自動的に再ロックされ、あなたが始めた作業をチームメイトが 誤って自分のものにしてしまうのを防ぎます。

ロック解放のリクエスト

チームメイトがロックしているアセットを変更したい場合、プラグインから解放リクエストを送信できます。 通知はチームメイトの desktop クライアントに届きます。

よくある問題

「Failed to connect to source control」

desktop クライアントに正しくログインしているか確認してください。認証情報を保持しているのはそちらです。

プラグインがアップデートされない

まず Unreal エディタを閉じてください：プラグインは読み込まれている間は置き換えられません。 次に desktop クライアントの Unreal パネルにあるプラグインのステータスバッジをクリックして、 チェックを再実行しアップデートを適用してください。