◀ 19.

UE5 Get Overlapping Actorsで特定クラスだけ処理｜Class Filter・Cast To

▶
編集
この記事の要点
  • Get Overlapping Actors はオーバーラップ中の全アクターを取得する関数。Class Filter 入力にクラスを指定すれば取得段階で絞り込める
  • Class Filter を使えば Cast To 不要で高速。動的に判定したいときだけ For Each Loop + Cast To で個別判定する
  • 「重なった瞬間」だけ拾いたいなら OnComponentBeginOverlap イベントを使い、Other Actor を Cast するのが定石
  • コリジョン設定の Generate Overlap Events と Collision Response が正しくないと一切ヒットしない
  • パフォーマンス的には Class Filter > BeginOverlap で個別判定 > 全件取得後ループ の順に効率的

はじめに

Unreal Engine 5 でトリガーやコリジョン領域に「特定のクラスのアクターだけ反応させたい」というニーズはとても多くあります。本記事では Get Overlapping Actors ノードの使い方と、クラスでフィルタする 3 つのパターンを、初心者にも分かるよう順を追って解説します。

Get Overlapping Actors とは

あるアクター（または Primitive Component）と現在重なっているすべてのアクターを配列で返すノードです。トリガーボックスに 5 体の敵がいれば、5 体分の Actor 参照が返ってきます。

場所用途
Actor 上で呼ぶそのアクター全体に重なっているアクター
Primitive Component 上で呼ぶそのコンポーネント（Box Collision など）に重なっているアクター

前提：コリジョン設定

そもそもオーバーラップが発生しないと何も取得できません。次の 3 つを必ず確認します。

  1. 当該コンポーネントの Generate Overlap Events が ON
  2. Collision Preset が OverlapAll / OverlapAllDynamic など、対象クラスを Overlap 許可している
  3. 判定対象のアクター側も Collision Enabled = Query and Physics または Query Only

方法 1：Class Filter で取得時に絞り込む（推奨）

Get Overlapping Actors ノードには Class Filter という入力があります。ここにクラスを指定するだけで、該当クラスとその子クラスのみが結果に含まれます。

つなぎ方

  1. 当該コンポーネント（例: Box Collision）の参照を取得
  2. Get Overlapping Actors ノードを置く
  3. Class Filter ピンに対象クラス（例: BP_Enemy）をセット
  4. 戻り値の配列に対して For Each Loop で処理

メリット

  • Cast To が不要（既にクラスが確定している）
  • 取得段階で対象外を弾くため処理が高速
  • 子クラスも自動でマッチする（BP_Enemy_Slime / BP_Enemy_Goblin など）

方法 2：取得後に Cast To で判定

Class Filter が使えない事情（例: 複数クラスを同時に判定したい）があるときは、全件取得して個別に Cast します。

つなぎ方

  1. Get Overlapping Actors（Class Filter は空）
  2. For Each Loop
  3. Array Element に対して Cast To BP_Enemy
  4. Cast Succeed の出力で処理（例: Apply Damage）

2 クラス以上を分岐させたい場合は、Cast を順番に試して最初に成功した分岐で処理します。Switch on Class 系のプラグインや関数を自作する手もあります。

方法 3：Begin Overlap イベントで個別判定

「重なった瞬間」だけ反応させたいなら Get Overlapping Actors よりも OnComponentBeginOverlap イベントが適しています。Other Actor 引数を Cast すれば判定 1 回で済みます。

つなぎ方

  1. Box Collision を選択 → Details パネルの「On Component Begin Overlap」+ ボタン
  2. イベントノードが生成される
  3. Other Actor ピンを Cast To BP_Enemy
  4. Cast Succeed → 任意の処理（HP 減算 / SE 再生 / アイテム消費）

BeginOverlap vs Get Overlapping Actors の使い分け

シーン適切な方法
「初めて触れた瞬間」だけ反応OnComponentBeginOverlap
「離れた瞬間」も必要OnComponentEndOverlap も併用
「Tick で常に重なっているか確認」Get Overlapping Actors + Class Filter
「特定のイベントで現状をスナップショット」同上
「複数の同時オーバーラップを一括処理」Get Overlapping Actors + For Each Loop

応用：条件を組み合わせる

「BP_Enemy のうち、HP が 50% 以下のものだけ処理」のような条件分岐は、Class Filter + 内部変数チェックで実現します。

  1. Class Filter に BP_Enemy を指定して取得
  2. For Each Loop で各 Enemy にアクセス
  3. 各 Enemy の HP 変数 / 状態 enum を取得
  4. Branch で条件判定 → 処理

パフォーマンスの目安

方法負荷備考
BeginOverlap で 1 回判定低イベント駆動、最も効率的
Get Overlapping Actors + Class Filter低〜中取得段階で絞られる
Get Overlapping Actors + Cast To ループ中件数 × Cast コスト
Tick から毎フレーム呼ぶ高避ける、必要ならタイマーで間引く

よくあるトラブル

症状原因と対処
何も取得できないGenerate Overlap Events が OFF / Collision Preset がブロック設定 / 対象アクターの Collision Enabled が NoCollision
Cast が常に失敗対象が継承していない / Blueprint クラスの選択ミス（Native vs Blueprint）
BeginOverlap が複数回発火子コンポーネントごとに発火している。Other Comp で判別 or Cast 後にフラグ管理
Class Filter の結果に子クラスが入らないクラスがコンパイル時の親と異なる / 別ブランチの BP。継承関係を確認
OverlapAllDynamic なのに敵が反応しない敵側が Static で Generate Overlap Events OFF。両者を Dynamic + Query Only に

FAQ

Q: Get Overlapping Components との違い？
A: 似ていますが、コンポーネント単位で結果を返します。「どの当たり判定コンポーネントに重なっているか」が必要なときに使います。

Q: C++ から使う場合は？
A: UPrimitiveComponent::GetOverlappingActors(TArray<AActor*>& OverlappingActors, TSubclassOf<AActor> ClassFilter) で Class Filter を渡せます。

Q: 連打防止には？
A: アクター側に bAlreadyHit のようなフラグを持たせ、Begin Overlap 時に確認・セットします。

関連

編集
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 13:10:10 T 166

人気ページ

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