ORENDA WORLD
    2026/3/30エンジニア

    “Blueprintで発生したコンフリクトを解決してみよう”

    “UnrealEngineのソースコントロールツールを用いたブループリントの競合解決方法”

    執筆:  “NN”

    はじめに

    Gitなどのバージョン管理システムを使って複数人の開発を行っているとコンフリクト（競合）が発生することがあります。

    ここではGitを用いたプロジェクトにおいて、ブループリント上のコンフリクトが生じた場合に、ソースコントロールツールを用いて解決する方法をご紹介します。

    この記事の内容

    この記事では、特に以下のポイントについて詳しく解説します。

    1. 開発内容を別のブランチからマージ（統合）する方法

    2. マージでコンフリクトが発生した際の解消方法

    プロジェクトのリポジトリを用意しよう

    今回必要なものは４種類です。

    1. Gitクライアント
    2. Unreal Engine5.2
    3. Unreal Engineプロジェクト
    4. プロジェクトのGitリポジトリ

    ※こちらの詳しい作成方法は当ブログ内の記事「UEエディタ上ソースコントロールツールのつかいかた」で紹介しています。

    追加ブランチでコミットしてみよう

    featureブランチの追加

    「UEエディタ上ソースコントロールツールのつかいかた」で作成したdevelopブランチから、更に派生ブランチを作成して切り替えます。

    1. ターミナルを開きdevelopブランチへ切り替え
      （既にdevelopブランチの場合は不要）
    1. developブランチからfeature/update-actorブランチを作成して切り替え
      （-bオプションを付けるとブランチを作成した上で切り替わる）
    1. 以下のメッセージが表示されればfeatureブランチ作成と切り替え成功

    featureブランチでファイル更新

    まず、現在のfeatureブランチで A_TestActor を更新します。

    1. 「UEエディタ上ソースコントロールツールのつかいかた」で作成済みのファイルである A_TestActor をダブルクリック
    1. 以下画面が表示されたら上部ブループリントエディタを開くをクリック
      （もしそのままブループリントエディタが表示されていたら次へ）
    1. イベントグラフ上を一度クリックした後、キーボードの「D」+ マウスクリックでdelayノードを追加（違うノードでもOK）
    1. コンテンツブラウザ上からA_TestActorをクリックした後、ctrl + S で保存
    1. 赤いチェックマークが表示されれば更新完了

    featureブランチでコミット

    続いて更新したファイルをfeatureブランチ上でコミットします。

    1. ターミナルを開き更新したファイルをステージング
    1. 念のためにステージングされたファイルを確認
    1. 以下のようなメッセージでステージングされたファイルが表示される
    1. A_TestActorがステージングされていることが確認出来たら、「update actor」のメッセージを付けてコミット
    1. 以下メッセージが表示されればコミット成功

    コンフリクトを発生させてみよう

    developブランチでファイル更新

    まず、同じA_TestActorをdevelopブランチ上で更新します。

    1. 現在のfeatureブランチからdevelopブランチへチェックアウト
    1. 以下メッセージが表示されればチェックアウト成功
    1. A_TestActor をダブルクリック
    1. 以下画面が表示されたら上部ブループリントエディタを開くをクリック
      （もしそのままブループリントエディタが表示されていたら次へ）
    1. 先ほど配置したdelayノードが存在していないことを確認
      （ブランチが異なるため）
    1. イベントグラフ上をクリックした後キーボードの「C」を押してノードコメントを追加
    1. コンテンツブラウザ上からA_TestActorをクリックした後、ctrl + S で保存
    1. 赤いチェックマークが表示されれば更新完了

    developブランチでコミット

    続いて更新したファイルをfeatureブランチ上でもコミットします。

    1. ターミナルを開き更新したファイルをステージング
    1. 念のためにステージングされたファイルを確認
    1. 以下のようなメッセージでステージングされたファイルが表示される
    1. A_TestActorがステージングされていることが確認出来たら、「update actor」のメッセージを付けてコミット
    1. 以下メッセージが表示されればコミット成功

    featureブランチをdevelopブランチへマージ

    ここまでで現在、developブランチとfeatureブランチの両方で同じファイルを更新した状態になっているはずです。

    この状況でマージすることにより、コンフリクトを発生させます。

    1. ターミナルを開きfeature/update-actorブランチをdevelopブランチにマージ
    1. 以下メッセージとともにコンフリクトが発生

    コンフリクトを解決してみよう

    コンフリクトの内容を確認

    ソースコードであればVSCodeなどからコンフリクトの状態を確認できますが、ブループリントの場合はUnrealEngineのソースコントロールツールを使わないと、詳細を確認できません。

    UnrealEngineのエディタからコンフリクトの状態を確認してみましょう。

    1. uprojectファイルをダブルクリックしてエディタを起動
    1. A_TestActorに「赤矢印が向かい合ったアイコン」が付いている（=競合状態である）ことを確認
    1. A_TestActorを右クリックしてリビジョンコントロール > マージを選択
    1. 開いたマージツールの左メニューを確認する
    1. オレンジ色になっている部分が更新部分なのでクリック
    1. 以下の形で表示されるので、グラフ上の同じ部分で更新されている内容（5の画像を参照）を確認する
      1. 右側｛ソース（REMOTE）｝：現在のブランチ（develop）
        • Delayノードが配置されている
      2. 中央（ベース）：マージした結果となるコミット内容
      3. 左側｛TARGET（LOCAL）｝：取り込むブランチ（update-actor）
        • コメントが配置されている

    コンフリクトの解決

    2025年６月現在ではGitを使ったマージツールの「〇〇を承認する」から直接マージ操作を行うとエラーが発生します。

    そのためグラフ上でのコピーとペーストによる手動マージを行います。

    （両方の更新を取り込む場合はいずれにせよ手動でマージすることになります）

    1. マージツールを開いた時点で、A_TestActor自体のBPエディタも裏側で開いているはずなので、マージツールウインドウの左上タブをドラッグして、レベルタブとA_TestActorのタブに並べる
      （既に並んでいた場合はそのままでOK）

    ↓

    ↓

    1. ソース（REMOTE）のグラフ上でマウス右ボタンを押しながらドラッグ（グラフ全体をスライド）してDelayノードを表示させる
    1. Delayノード上で右クリックして表示される「コピー」をクリック
    1. ウインドウ上部のA_TestActorタブをクリックしてウインドウを切り替え

    ↓

    1. イベントグラフ上のコメントの下部あたりを右クリックしてからCtrl + Vで、コピーしたノードを貼り付け
    1. 左上のコンパイルボタンをクリックしてエラーが出ないことを確認

    ↓

    1. 左上の保存アイコンをクリックしてA_TestActorの修正を保存
    1. ウインドウ上部のマージツールタブをクリックしてウインドウを移動
    1. タブ下部の「マージを終了する」ボタンをクリック

    マージ作業のコミット

    マージ作業が完了したのでコンフリクトが解決されたことを確認してコミットを行います。

    1. レベルタブをクリックしてコンテンツブラウザを表示します。
    1. A_TestActorの表示アイコンが、コンフリクトアイコンから更新アイコン（赤いチェックマーク）に変わって競合が解決されていることを確認
    1. ターミナルを開き、以下コマンドで競合解決の更新内容をステージング
    1. 念のためにステージングされたファイルを確認
    1. A_TestActorがステージングファイルとして表示される
    1. 確認出来たら「Resolve merge conflicts」のメッセージを付けてコミット
    1. 以下メッセージが表示されればコミット成功

    マージしたブループリントを確認しよう

    コンフリクトを解決したファイルの確認

    エディタを起動してコンテンツブラウザからA_TestActorを開いた場合に、以下のように表示されていれば、競合を解決して正しくマージできています。

    別々のブランチで追加したはずのDelayノードとコメントが、一つのブループリント上に無事反映されました。

    まとめ

    今回はUnreal Engineのマージツールを使ってコンフリクトを解決する方法をご紹介しました。

    チーム開発で複数人がGitを介して作業を行うと、どうしてもコンフリクトが発生してしまうことがありますがソースコントロールツールを使えば、ブループリントでも競合個所を確認しながら安全に解決することができます。

    ただしレベルブループリントには使えないことや、Git使用では一部機能でエラーが発生することなど、まだまだ万能ではありません。
    （Gitでのマージツール機能は、現在2025年6月時点ではβ版）

    それでもブループリントでコンフリクトが発生した場合には、解決方法の一つとして便利なツールなので上手く役立ててみてください。

    関連記事

    ← 記事一覧に戻る