◀ 17.

UE5 グローバル カスタム イベント作成完全ガイド（GameInstance／Subsystem／Event Dispatcher）

▶
編集
この記事の要点
  • UE のカスタムイベントをレベル横断・どこからでも呼ぶ定石は GameInstance に Event Dispatcher を置くパターン
  • GameInstance はゲーム起動から終了までレベル切替を跨いで生き続けるシングルトン的存在
  • モダンな方法は UGameInstanceSubsystem。機能単位で分離でき、依存最小
  • Blueprint からは Get Game Instance → Cast To → Bind Event to ...／Call ...
  • 責務に応じて: PlayerController / GameMode / GameState / GameInstance / Subsystem を使い分け、Blueprint Interface はインタフェース契約に

「どこからでも呼べる」の意味

UE5 で「Blueprint からどこからでも呼び出せるカスタムイベント」を作りたい場合、その本質はグローバルな置き場（シングルトン）を確保することです。レベル（マップ）が切り替わるたびに破棄されない場所に、イベントの発信源を置きます。

置き場寿命用途
GameInstanceゲーム起動〜終了レベル跨ぎグローバル（推奨）
GameInstanceSubsystemゲーム起動〜終了機能別分割（モダン推奨）
GameStateレベル切替で破棄マップ内グローバル
GameModeレベル切替で破棄（サーバのみ）ルール定義
PlayerControllerプレイヤー単位入力・UI 制御
個別 Actorそのレベルのみローカル機能

方法1: GameInstance に Event Dispatcher を置く

最も古典的で確実な方法です。次の手順で進めます。

  1. Content Browser → 右クリック → Blueprint Class → Game Instance を継承 → BP_MyGameInstance
  2. Project Settings → Maps & Modes → Game Instance Class を BP_MyGameInstance に変更
  3. BP_MyGameInstance を開き、Event Dispatchers ペインで OnEnemyDefeated 等を追加
  4. イベント発信側: Get Game Instance → Cast To BP_MyGameInstance → Call OnEnemyDefeated
  5. イベント受信側: 同様に Cast → Bind Event to OnEnemyDefeated → カスタムイベントに接続
[Enemy_BP]              [HUD_BP]
   ↓ Defeated             ↓ BeginPlay
Get Game Instance       Get Game Instance
   ↓                       ↓
Cast To BP_MyGameInstance  Cast To BP_MyGameInstance
   ↓                       ↓
Call OnEnemyDefeated      Bind Event to OnEnemyDefeated
                            ↓
                         Custom Event: UpdateScore

方法2: GameInstanceSubsystem（推奨・モダン）

UE 4.22+ で導入された UGameInstanceSubsystem は、GameInstance を肥大化させずに機能ごとに分離できるモダンな仕組みです。Blueprint からは Get Game Instance Subsystem (BP_QuestSubsystem) でいきなり取れるため、Cast 不要でアクセスできます。

// MyQuestSubsystem.h
#pragma once
#include "CoreMinimal.h"
#include "Subsystems/GameInstanceSubsystem.h"
#include "MyQuestSubsystem.generated.h"

DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnQuestCompleted, FName, QuestId);

UCLASS()
class MYGAME_API UMyQuestSubsystem : public UGameInstanceSubsystem
{
    GENERATED_BODY()
public:
    UPROPERTY(BlueprintAssignable, Category="Quest")
    FOnQuestCompleted OnQuestCompleted;

    UFUNCTION(BlueprintCallable, Category="Quest")
    void CompleteQuest(FName QuestId)
    {
        OnQuestCompleted.Broadcast(QuestId);
    }
};

Blueprint からは以下のように使えます。

[発信側]
Get Game Instance Subsystem (MyQuestSubsystem)
   → Complete Quest (QuestId="DragonSlain")

[受信側 - BeginPlay 等で]
Get Game Instance Subsystem (MyQuestSubsystem)
   → Bind Event to On Quest Completed
   → Custom Event handler でクエスト UI 更新

方法3: Blueprint Interface

「呼び方の契約」だけ共有したい場合は Blueprint Interface を使います。シングルトンとは異なり、対象 Actor が分かっているケースで利用します。

  1. Content Browser → Blueprint Interface → BPI_Damageable 作成
  2. Function: ReceiveDamage(int32 Amount) を追加
  3. 各 Actor の Class Settings → Interfaces → Add で BPI_Damageable を実装
  4. 呼ぶ側: Receive Damage (Message) ノードで、Target に Actor を渡す

方法4: シーン跨ぎの永続データ

イベントだけでなく値も保持したいなら、GameInstance のメンバ変数（Save Game との連携も）を使います。

用途置き場備考
レベル間のスコア／所持金GameInstance 変数メモリ上のみ。閉じると消える
セーブデータSaveGame オブジェクトファイル書き込み
ステージ間の進捗GameInstance + SaveGame両立
ネットワーク同期データGameState / Replicatedマルチプレイ向け

レベル間通信のフロー例

Level_Field（フィールドマップ）
  Player が敵に勝利
    → GameInstance.OnVictory(EnemyId, Reward) を呼ぶ
    → GameInstance に Reward を保存
    → Open Level "Level_Result"

Level_Result（リザルト画面）
  BeginPlay
    → Get Game Instance.GetReward() で値取得
    → UI に表示

注意点と落とし穴

  • GameInstance クラスを設定し忘れると、いくら Blueprint を作っても使われない（Project Settings 必須）
  • Subsystem は引数なしの Initialize しか持てない。データは Initialize 内で別から取得
  • Event Dispatcher の Bind は重複防止のために Unbind を意識。EndPlay で Unbind All を推奨
  • Actor が破棄された後でも Bind が残るとクラッシュリスク。Weak Reference / EndPlay で確実に解除
  • マルチプレイ環境では、GameInstance はクライアント／サーバそれぞれにあるため、同期は別途 Replication 設計が必要

C++ から Multicast Delegate を公開する

// マルチキャストデリゲートで Blueprint からも Bind 可能に
UCLASS(Blueprintable)
class UMyEventBus : public UGameInstanceSubsystem
{
    GENERATED_BODY()
public:
    DECLARE_DYNAMIC_MULTICAST_DELEGATE(FOnPause);
    UPROPERTY(BlueprintAssignable) FOnPause OnPause;

    UFUNCTION(BlueprintCallable) void Pause() { OnPause.Broadcast(); }
};

FAQ

Q: GameInstance と Subsystem、どちらを使うべき？
A: 新規プロジェクトは Subsystem。GameInstance を肥大化させず機能ごとに分離できます。既存プロジェクトの拡張なら GameInstance に追加で問題なし。

Q: PlayerController に置くのとどう違う？
A: PlayerController はプレイヤー単位。ローカルマルチでは複数生成され、レベル切替で破棄されます。ゲーム全体のイベントには不向き。

Q: Bind がリークしたとき？
A: 破棄済 Actor のハンドラに Broadcast すると Access None / クラッシュの原因になります。Actor の EndPlay で Unbind を呼ぶ習慣を。

編集
Post Share
子ページ

子ページはありません

同階層のページ
  1. 床の上に乗ったらイベントを発生させる方法
  2. OverlapAllDynamicとOverlapAllの違い
  3. タイトル画面を作る方法
  4. サードパーソンテンプレートでのキャラクター表示の仕組みと非表示にする方法
  5. ボタンに文字を記載する方法
  6. Event ActorBeginOverlapとOn Component Begin Overlapの違い
  7. キャラクターに特定のオブジェクトとの当たり判定を付ける
  8. 特定のオブジェクトに触れたとき、キャラクターが倒れるようにする
  9. 動いているオブジェクトに静止しているキャラクターが当たり判定を持たない原因と解決方法
  10. 「On Component Hit」に「Cast To ～」で複数のクラスを指定する方法
  11. Blenderファイルをインポートする方法
  12. 鏡を作成する方法
  13. レベルブループリントでキャラクターの出現を設定する方法
  14. サードパーソンテンプレートにおけるキャラクター出現の定義
  15. アイテムに近づいたらボタンを押してイベントを発火させる方法
  16. 画面の中央にメッセージを表示する方法
  17. どこからでも呼び出せるカスタムイベントを作成する方法
  18. カスタムイベントに引数を追加する方法
  19. 「Get Overlapping Actors」から特定のクラスの場合のみ処理を実行する方法
  20. オブジェクトに近づいている間だけメッセージを表示する方法
  21. PCの画面を操作するUIを作る方法
  22. コンテンツブラウザに画像を追加する方法
  23. SetInputMode_UIOnlyを取り消す方法
  24. 特定の画像の上にマウスカーソルを置いたら手マークにする方法
  25. オブジェクトがアウトライナーで選択できない原因と解決策
  26. PlayerStartを作成する方法
  27. メニュー画面を作成して開く方法
  28. 「Esc」キーを押してメニュー画面を開く方法
  29. イベントの「On Clicked」と「On Pressed」の違い
  30. 「Set Input Mode」の種類と使い方
  31. 「Set Game Paused」の使い方と詳細解説
  32. Motion Matchingとは？
  33. 「GameMode」と「GameModeBase」の違い
  34. マップに配置したTargetPointを取得する方法
  35. TargetPointにタグをつけて取得する方法
  36. Spawnしたインスタンスがイベントを実行する方法
  37. 特定の時間ごとに処理を実行する方法
  38. 数値をランダムで出力する方法
  39. ThirdPersonテンプレートでキャラクターの移動を歩くように変更する方法
  40. MaxWalkSpeedを変更する方法
  41. しゃがむ動作を導入する方法
  42. キャラクターのアニメーションを設定する方法
  43. 導入済みのプラグインを確認する方法
  44. Motion Matchingの導入と必要なプラグイン
  45. プレイヤーを非表示にする方法
  46. カメラを傾ける角度を制限させる方法
  47. 配列からランダムに重ならない要素を特定の数取得する方法
  48. カメラの映す画面に文字やエフェクトを付ける方法
  49. キャラクターやメッシュを非表示にした際にカメラが移動しなくなる問題の解決方法
  50. プライマリーデータアセットを活用する方法
  51. プレイヤーのHPといった変数を定義する最適な場所
  52. カメラに映った画面をスクリーンショットとして保存する方法
  53. ゲーム内のカメラ映像を保存して再表示する方法
  54. HighResShot を使って高解像度の画像を保存する方法（UE5）
  55. HighResShotで保存した画像のファイル名を取得する方法
  56. SceneCapture2DとFrameGrabberの画像保存方法の比較
  57. SceneCapture2Dを使用して画像を保存・取得する方法
  58. HighResShotとTake High Res Screenshotの違い
  59. ゲーム終了ボタンを作成する方法
  60. 「Save Game To Slot」の戻り値がfalseになる問題の解決方法
  61. 画面上にメッセージを指定された時間表示させる方法
  62. シェーダコンパイル時間を短縮する方法
  63. 「Take High Res Screenshot」実行時に「シェーダをコンパイル」に長時間待たされる問題とその解決策
  64. データベースを活用する方法
  65. UE5.5がインストールされた環境にUE5.4を追加で導入する方法
  66. World PartitionとWorld Compositionの違い
  67. オープンワールドテンプレートとは？
  68. ポーンをスポーンさせても視点を切り替えない方法
  69. キャラクター同士がすり抜けてしまう問題の解決方法
  70. キャラクターの外見を動的に変更
  71. World Partitionでインスタンスが「アンロード済み」になる問題
  72. データ アセットとデータ テーブルの違い
  73. コンポーネントイベントグラフ内で親クラスの変数にアクセスする方
  74. エディターのソースコードの自動保存の頻度を高める方法
  75. SpawnActorでSpawn Transform Rotationが反映されない理由
  76. ミニマップを表示しポーンの位置を反映する方法
  77. RInterp ToとVInterp Toの違い
  78. 毎秒実行するイベントの定義方法
  79. Niagara のエフェクトにコリジョンを持たせる方法
  80. 「Overlap」と「Hit」の違い
  81. OverlapはあるがHitがない原因
  82. Overlapした位置の座標を取得する方法
  83. ブループリントでレベル間のパラメータを受け渡す方法
2026-06-11 07:12:00 T 382

人気ページ

最近更新/作成されたページ