タイトル: on component begin overlap
SEOタイトル: UE5のOn Component Begin Overlapとは｜発火条件と使い方・取得できる情報
On Component Begin Overlapは、あるコンポーネントが他のコンポーネント（やアクター）と重なり始めた瞬間に発火するブループリントのイベントです。プレイヤーがトリガーゾーンに踏み込んだ、アイテムにキャラクターが触れた、といった「接触の開始」を検知するための基本的な仕組みで、UE5でのインタラクション実装の入り口になります。このイベントは特定のコンポーネントに結び付いており、発火と同時に「誰が」「どのコンポーネントで」重なったかといった情報を受け取れるのが特徴です。
| この記事の要点 |
|---|
|
On Component Begin Overlapとは何か
On Component Begin Overlapは、コリジョンを持つコンポーネント（Box Collision、Sphere Collision、Static Mesh、Skeletal Meshなど）が、他のオブジェクトと重なり始めたタイミングで一度だけ呼び出されるイベントノードです。たとえば、ドアの手前に置いた見えない判定領域にプレイヤーが入った瞬間や、回転するコインにキャラクターが触れた瞬間を捉えられます。
重要なのは、このイベントがアクター全体ではなく「特定のコンポーネント」に紐付くという点です。コンポーネントを選択した状態でイベントを追加するため、1つのアクターに複数のコリジョンコンポーネントがある場合、それぞれに別々のOn Component Begin Overlapを用意して、コンポーネントごとに異なる反応をさせることができます。
名前が示すとおり「Begin（開始）」のイベントであり、重なっている間ずっと毎フレーム呼ばれ続けるわけではありません。重なり始めの1回だけ発火し、対象が範囲から出るときには別のイベント（後述のOn Component End Overlap）が呼ばれます。
イベントが発火する前提条件
On Component Begin Overlapは、ノードを置いただけでは反応しないことがあります。オーバーラップが検知されるには、コリジョンに関するいくつかの設定が揃っている必要があります。設定が一つでも欠けるとイベントが呼ばれないため、想定どおり動かないときはまずここを疑うのが定石です。
| 条件 | 内容 |
|---|---|
| Generate Overlap Events | オーバーラップを発生させたいコンポーネント側でこの項目が有効になっている必要があります。一般に、関係する双方のコンポーネントで有効にしておくのが確実です。 |
| コリジョン応答がOverlap | 双方のコリジョン設定で、対象となるオブジェクトタイプ同士の応答がOverlapになっている必要があります。BlockやIgnoreではオーバーラップイベントは発生しません。 |
| コリジョンが有効 | コンポーネントのCollision Enabledが、少なくともクエリ（Query）を含む設定になっている必要があります（例: Query Only や Collision Enabled）。No Collisionでは検知されません。 |
コリジョンの応答は、各コンポーネントのCollision Presets（コリジョンプリセット）でまとめて設定できます。用意されたプリセット（OverlapAll、OverlapAllDynamic、Triggerなど）を選ぶか、Customを選んでオブジェクトタイプごとに「Overlap / Block / Ignore」を個別に指定します。トリガーのように「ブロックはしないが重なりだけ検知したい」用途では、Overlap中心の設定にするのが一般的です。
イベントから取得できる情報（ピン）
On Component Begin Overlapノードには、発火時に出力される複数のピンがあります。これらを使うことで「何が重なったのか」を判断し、処理を分岐できます。
| ピン名 | 意味 |
|---|---|
| Overlapped Component | このイベントを受け取った側、つまり重なりを検知した自分自身のコンポーネントです。 |
| Other Actor | 重なってきた相手のアクターです。プレイヤーかどうかの判定などで最もよく使われます。 |
| Other Comp | 相手アクターの中で、実際に重なったコンポーネントです。同じアクターでも、どのコンポーネントが触れたかを区別したいときに使います。 |
| Other Body Index | 相手側で重なった物理ボディのインデックスです。スケルタルメッシュなど複数ボディを持つ対象で意味を持ちます。 |
| From Sweep | この重なりがスイープ（移動による掃引判定）に由来するかどうかを表すブール値です。 |
| Sweep Result | スイープ由来の場合のヒット情報です。From Sweepが真のときに位置や法線などの詳細を含みます。 |
たとえばOther ActorをCast Toノードに通せば、相手が特定のクラス（プレイヤーキャラクターや敵など）であるかを判定し、合致した場合のみ処理を続けるといった分岐が作れます。
On Component End Overlapとの対
On Component Begin Overlapは「重なり始め」のイベントであり、これと対になるのがOn Component End Overlapです。前者が範囲に入った瞬間、後者が範囲から出た瞬間に発火します。
この2つを組み合わせると、「範囲内にいる間だけ何かをオンにする」という状態管理が実現できます。たとえば、On Component Begin Overlapでヒント表示をオンにし、On Component End Overlapでオフにすれば、プレイヤーがエリアにいる間だけUIを出す、といった挙動になります。なお、End Overlap側にはSweep関連のピンはなく、相手の情報を表すピン（Other Actor、Other Compなど）が提供されます。
Event ActorBeginOverlapとの違い
UE5には似た名前のイベントとしてEvent ActorBeginOverlap（On Actor Begin Overlap）があり、混同しやすいポイントです。両者の主な違いは検知する単位にあります。
| 項目 | On Component Begin Overlap | Event ActorBeginOverlap |
|---|---|---|
| 検知の単位 | 特定のコンポーネント単位 | アクター全体（いずれかのコンポーネントが重なれば反応） |
| 自分側の情報 | Overlapped Compとして、どのコンポーネントかが分かる | どのコンポーネントで重なったかは直接は出力されない |
| 取得できる相手情報 | Other Actorに加えてOther Compなども取得できる | 主にOther Actor（相手アクター） |
| 向いている用途 | 複数の判定コンポーネントを使い分けたい場合 | アクター単位で「何かが触れた」を大まかに扱いたい場合 |
一般に、これらは独立した別系統ではなく、コンポーネント側のオーバーラップが成立すると、それを含むアクター側のイベントも呼ばれる関係にあります。そのため、Event ActorBeginOverlapが反応しないときも、まずはコンポーネント側のコリジョン設定を確認するのが有効です。どのコンポーネントで触れたかを細かく区別したいならOn Component Begin Overlap、アクターとして触れられたことだけを大まかに扱いたいならEvent ActorBeginOverlap、と使い分けると整理しやすくなります。
使い方の例
例1: トリガーゾーンでメッセージを表示する
見えない判定領域にプレイヤーが入ったら通知する、というシンプルな例です。
- アクターにBox Collisionなどのコリジョンコンポーネントを追加し、判定したい範囲に合わせてサイズを調整します。
- そのコンポーネントのコリジョンプリセットを、プレイヤーとの応答がOverlapになるよう設定し、Generate Overlap Eventsを有効にします。
- コンポーネントを選択した状態でOn Component Begin Overlapイベントを追加します。
- Other ActorをCast To（対象のキャラクタークラス）に接続し、相手がプレイヤーのときだけ後続を実行するようにします。
- キャスト成功側にPrint Stringなどを接続し、メッセージや任意の処理を実行します。
例2: アイテム取得
フィールドに置いたアイテムにプレイヤーが触れたら取得する、という流れもよく使われます。アイテム側のコリジョンコンポーネントにOn Component Begin Overlapを置き、Other Actorがプレイヤーであることを確認したうえで、所持数の加算やアイテムアクター自身のDestroy Actorを行います。重なりを取りこぼさないよう、コリジョン応答とGenerate Overlap Eventsの設定を忘れないことがポイントです。
よくある落とし穴
| 落とし穴 | 対処 |
|---|---|
| Generate Overlap Eventsを有効にし忘れる | 最も多い原因です。検知したいコンポーネントでこの項目を有効にします。相手側にも有効化が必要なケースがあるため、双方を確認します。 |
| 片側の設定だけ見ている | オーバーラップは双方の設定で成立します。自分側がOverlapでも、相手側がIgnoreやBlockだと発火しません。両者のコリジョン応答を突き合わせて確認します。 |
| 応答がBlockになっている | Blockは物理的に押し返す応答で、オーバーラップイベントとは別です。重なりを検知したい対象タイプの応答はOverlapに設定します。 |
| 相手を判別せず処理してしまう | 範囲には地面や他のオブジェクトも入り得ます。Other Actorを判定（Cast Toなど）して、意図した相手のときだけ処理するようにします。 |
| 自分自身のコンポーネントとの重なり | 同一アクター内の別コンポーネントと重なって反応することがあります。Other Actorが自分自身でないかをチェックして除外すると安全です。 |
よくある質問（FAQ）
Q. On Component Begin Overlapを置いたのに何も起きません。
A. まずGenerate Overlap Eventsが有効か、双方のコリジョン応答がOverlapになっているか、コリジョンがクエリを含む設定になっているかを確認してください。これらのいずれかが欠けていると発火しません。
Q. 重なっている間ずっと処理を続けたいのですが、このイベントで毎フレーム呼ばれますか。
A. いいえ。このイベントは重なり始めの1回だけ呼ばれます。継続的な処理が必要なら、Begin OverlapとEnd Overlapでフラグを切り替え、その間だけTickなどで処理する形にします。
Q. Other ActorとOther Compの違いは何ですか。
A. Other Actorは相手のアクター（オブジェクト全体）、Other Compはそのアクターの中で実際に重なった個々のコンポーネントを指します。相手の種類を判定するだけならOther Actor、同じアクター内のどの部位が触れたかを区別したい場合はOther Compを使います。
まとめ
On Component Begin Overlapは、特定のコンポーネントが他と重なり始めた瞬間を検知する、UE5のインタラクション実装の土台となるイベントです。発火にはGenerate Overlap Eventsの有効化と双方のコリジョン応答（Overlap）が前提となり、ここを外すと反応しません。Other ActorやOther Compといったピンで相手を特定し、On Component End Overlapと組み合わせれば「範囲内にいる間だけ」の状態管理も実現できます。アクター単位で扱うEvent ActorBeginOverlapとの違いも押さえておくと、目的に合ったイベントを選びやすくなります。仕様の細部はバージョンやプロジェクト設定によって挙動が変わる場合があるため、最終的な確認は公式ドキュメントや実機での検証をおすすめします。