◀ 10.

UE5のOn Component Hitで複数クラスをCast To判定する方法と設計のコツ

▶
編集

Unreal Engine 5（以下UE5）の「On Component Hit」イベントでヒットした相手を複数のクラスに対して判定するには、1つ目の「Cast To ～」ノードの「Cast Failed」ピンから次の「Cast To ～」へ実行を連結していくのが基本です。ただしクラスが増えるほどノードが横に伸びて保守しづらくなるため、対象に共通点があるなら共通の親クラス（基底クラス）への1回のCastかBlueprint Interface（ブループリントインターフェース）での判定にまとめる設計が推奨されます。本記事では、まず単一のCast Toを押さえたうえで、複数クラスを順に判定する具体的な書き方と、より良い設計への置き換えまでを解説します。

この記事の要点
  • 「On Component Hit」はコンポーネント同士が衝突した瞬間に発火するイベント。発火には衝突側コンポーネントで「Simulation Generates Hit Events」を有効化する必要がある。
  • 「Cast To ～」は対象が指定クラスか判定するノード。成功時は「As ～」出力、失敗時は「Cast Failed」実行ピンが流れる。
  • 複数クラスを判定する素朴な方法は、Castの「Cast Failed」ピンを次のCastの実行入力につなぐ連結（チェーン）。
  • クラスが多い・共通処理がある場合は、共通親クラスへのCastまたはBlueprint Interfaceでまとめると分岐が激減し保守しやすい。
  • Hitイベントが出ないときは、まずコリジョン設定と物理シミュレーションの有無を疑う。

「On Component Hit」とは

「On Component Hit」（On Component Hit (ComponentName)）は、対象コンポーネントが他のオブジェクトと「ブロック」する衝突を起こした瞬間に発火するイベントです。Blueprintのコンポーネントを選択した状態で「Details」パネルの「Events」欄から追加できます。発火すると、衝突相手の情報を以下のようなピンで受け取れます。

  • Other Actor：ヒットした相手のアクター。クラス判定はこのピンを起点にすることが多い。
  • Other Comp：ヒットした相手のコンポーネント。
  • Hit：衝突位置・法線などを含む Hit Result 構造体。

重要なのは、イベントを発火させるにはコリジョン設定が正しく整っている必要がある点です。物理シミュレーションによる衝突でHitイベントを得るには、衝突するコンポーネントの「Details」パネルで「Simulation Generates Hit Events」を有効（チェックオン）にしておきます。これが無効だと、見た目上は衝突していてもイベントは流れません。加えて、相手と「Block」し合うコリジョン設定（Collision Presets / Object Type と Collision Responses）になっていることも前提です。なお詳細な挙動はUE5のバージョンで差異が出ることがあるため、最終的な確定は公式ドキュメントの確認を推奨します。

単一クラスを「Cast To ～」で判定する基本

「Cast To ～」ノードは、入力オブジェクトが指定したクラス（またはその派生）のインスタンスかどうかを判定し、そうであれば指定クラス型として扱えるようにするノードです。挙動は次の2系統に分かれます。

  • 成功：通常の実行出力ピンが流れ、「As ＜クラス名＞」出力からそのクラス型の参照が得られる。
  • 失敗：「Cast Failed」実行ピンが流れる（入力が対象クラスではなかった場合）。

まずは1クラスのみ判定する最小の流れです。Other Actor を Cast To のObjectピンへつなぎ、成功側に処理を書きます。

On Component Hit
  └─ Other Actor ──▶ Cast To BP_Enemy（Object 入力）
     ├─ 実行出力（成功）─▶ As BP Enemy ──▶ Apply Damage など
     └─ Cast Failed（失敗）─▶ （ここでは何もしない）

複数のクラスを順に判定する書き方（Cast失敗からの連結）

「相手が ClassA なら処理A、ClassB なら処理B、…」のように複数クラスを順番に試したい場合は、最初のCastの「Cast Failed」ピンを次のCastの実行入力につなぐのが定石です。成功したCastの先で個別処理を行い、失敗したら次の候補クラスへ進む、という流れになります。

On Component Hit ─▶ Cast To BP_Enemy
  ├─ 成功 ─▶ As BP Enemy ─▶ 処理A
  └─ Cast Failed ─▶ Cast To BP_Item
     ├─ 成功 ─▶ As BP Item ─▶ 処理B
     └─ Cast Failed ─▶ Cast To BP_Wall
         ├─ 成功 ─▶ As BP Wall ─▶ 処理C
         └─ Cast Failed ─▶ （どれにも該当しない）

すべてのCastは同じ Other Actor を入力にします。各CastのObjectピンへ Other Actor をつなぐ点に注意してください。Castは派生クラスも成功扱いになるため、判定の順序を「より具体的なクラス → 一般的なクラス」にすると意図通り分岐できます。

この連結方式は分かりやすい反面、クラスが増えるほどノードが横に長く伸び、修正時にどのピンがどこへ流れるか追いづらくなります。3〜4クラスを超えるあたりから、次に挙げる設計への置き換えを検討するとよいでしょう。

より良い設計：共通親クラス／Blueprint Interface でまとめる

判定したいクラス群に共通の役割や処理があるなら、Castを並べる代わりに「まとめて扱える土台」を用意するほうが保守性・拡張性ともに優れます。代表的な3つの手法を比較します。

手法 判定方法 向いている状況 利点 / 注意点
Cast Failed の連結 各クラスへ順にCast、失敗で次へ 対象が少数（〜3クラス）で、クラスごとに全く別処理 直感的だが、増えると横に伸び保守しづらい。共通点が薄い場合の選択肢。
共通の親クラスへCast（推奨） 対象を1つの基底クラスから派生させ、その親へ1回だけCast 対象が共通の変数・関数を持ち、is-a関係で表せる 分岐が1回で済み、派生クラスを足しても判定側は無修正。継承の設計が前提。
Blueprint Interface（推奨） インターフェース実装の有無で判定／関数を呼ぶ 継承関係が異なるクラス群に共通の「ふるまい」を持たせたい Castより疎結合で参照を抱えにくい。「Does Implement Interface」や Interface Message で扱える。
Actor Tags で判定 アクターに付けたタグを「Actor Has Tag」で確認 クラス設計を変えずに緩く分類したい 手軽だがタグ文字列のtypoに弱く、型安全ではない。補助的に使う。

共通点があるなら、まず「共通親クラスへの1回のCast」か「Blueprint Interface」を第一候補にするのが、UE5のBlueprint設計として扱いやすい方針です。とくにInterfaceは、相手の具体クラスを参照として握らずに「この処理に対応しているか」だけを問えるため、依存関係を増やさずに済みます。

Blueprint Interface を使う場合の流れ

共通のふるまい（例：「ダメージを受ける」）をInterfaceとして定義し、各クラスに実装させておけば、Hit時はクラスを問わず一括で呼び出せます。

On Component Hit
  └─ Other Actor ──▶ Does Implement Interface（BPI_Damageable）
     ├─ True ─▶ Apply Damage（Interface Message）を Other Actor へ送信
     └─ False ─▶ （対象外として無視）

この形なら、新しいクラスを追加してもInterfaceを実装するだけで判定側のグラフは変更不要です。クラスごとに細かく分岐したいケースだけ、連結Castや親クラスCastと組み合わせます。

具体例：プレイヤーの弾が「敵」と「破壊可能オブジェクト」に当たったとき

弾アクターの衝突用コンポーネントに「On Component Hit」を設定し、相手が敵（BP_Enemy）か破壊可能物（BP_Breakable）かで処理を分ける例です。両者に共通する「ダメージを受ける」ふるまいがあるなら、Interfaceでまとめるのがすっきりします。

// 事前準備：BP_Enemy と BP_Breakable に BPI_Damageable を実装
// 衝突コンポーネントの「Simulation Generates Hit Events」を ON にしておく

On Component Hit (CollisionComp)
  └─ Branch（Other Actor が Self でないか）
     └─ True ─▶ Other Actor へ Interface Message「Take Hit Damage(Amount)」を送信
         └─ 弾を Destroy Actor

もし敵だけ特別なヒットエフェクトを出したい等、クラス固有の処理が必要な箇所だけ、Other Actor を「Cast To BP_Enemy」して成功側に追加します。「まとめられる部分はInterface、固有部分だけCast」という使い分けが現実的です。

よくある落とし穴
  • Hitイベントがそもそも発火しない：最も多い原因はコリジョン設定。衝突側コンポーネントの「Simulation Generates Hit Events」が無効、相手と「Block」していない、Collision Enabled が「Query Only/No Collision」になっている、などを確認する。物理で動く衝突では物理シミュレーション（Simulate Physics）と上記設定の組み合わせが必要。
  • Overlapと混同している：すり抜けながら範囲検知したい場合は Hit ではなく「On Component Begin Overlap」を使い、「Generate Overlap Events」を有効にする。HitとOverlapは発火条件が別物。
  • Castの判定順が逆：派生クラスは親クラスへのCastにも成功するため、一般的なクラスを先に判定すると具体クラスの分岐に到達しないことがある。具体クラス → 一般クラスの順にする。
  • 連結が長くなり保守不能：Castを延々と数珠つなぎにすると、可読性・拡張性が低下し、不要な参照（ハードリファレンス）も増えがち。共通親クラスやInterfaceへの置き換えを検討する。
  • Other Actor が自分自身：自分のコンポーネント同士やSelfを拾うことがあるため、必要に応じて「Other Actor != Self」のチェックを入れる。

FAQ

Q. 「Cast To ～」を複数つなげるのと、親クラス1回のCastは、結局どちらが良いのですか？
A. 対象クラスに共通の役割があり継承で表せるなら親クラス1回のCast、継承関係がバラバラならBlueprint Interfaceが扱いやすい設計です。連続Castは「対象が少数」「クラスごとに完全に別処理」のときの選択肢と考えるとよいでしょう。

Q. Cast を使わずにクラスを判定する方法はありますか？
A. あります。Blueprint Interfaceの「Does Implement Interface」で実装有無を判定する方法や、「Actor Has Tag」でタグを確認する方法です。Interfaceは型安全で疎結合、Tagは手軽ですが文字列管理になる点に注意してください。

Q. On Component Hit と Event Hit（ActorのHit）は何が違いますか？
A. 「On Component Hit」は特定のコンポーネント単位の衝突イベントで、どのコンポーネントが当たったかを起点に処理できます。アクター全体のHitを扱う「Event Hit」とは粒度が異なります。複数コンポーネントを持つアクターでコンポーネントごとに反応を変えたい場合は、On Component Hit が適しています。挙動の詳細はバージョン差があり得るため、公式ドキュメントの確認を推奨します。

まとめ

「On Component Hit」で複数クラスを判定する基本は、最初の「Cast To ～」の「Cast Failed」ピンから次のCastへ連結することです。ただしクラスが増えると保守しづらくなるため、共通点があるなら共通親クラスへの1回のCastかBlueprint Interfaceでまとめる設計を優先しましょう。そしてイベントが発火しないときは、まず「Simulation Generates Hit Events」を含むコリジョン・物理設定を見直すのが解決の近道です。

編集
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-12 14:12:49 atom 135

人気ページ

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