見た目の接触とTrigger通知を分ける
OnTriggerEnterは、少なくとも片方のCollider(当たり判定の形)でIs TriggerをONにした状態で、2つのColliderが重なり始めたときに呼ばれる処理です。この記事はUnity 2022.3 LTSの3D物理を対象にしています。見た目のメッシュが重なっていても、Colliderが離れていれば呼ばれません。まずTagなどで相手を選ぶ条件より前にログを入れ、OnTriggerEnterが呼ばれているかを確かめます。
1. ColliderとRigidbodyの組み合わせを確認する
接触する両側に有効な3D Colliderを用意し、少なくとも一方のIs TriggerをONにします。さらに、接触する組の少なくとも一方をRigidbodyに関連付けます。Rigidbodyは両側に必須ではなく、KinematicでもTrigger通知の対象になります。両側がRigidbodyのないStatic Colliderだけの組み合わせでは通知できません。
図は固定のBoxColliderをTriggerにし、移動側をColliderとRigidbodyの組み合わせにした一例です。Rigidbodyが親、Colliderが子という構成もあるため、見た目の階層だけで判断せずCollider.attachedRigidbodyで所属を確認します。同じRigidbody配下の複数Colliderを互いに重ねるテストではなく、別の物理ボディとの接触で確認します。
2. Layerと無視設定を確認する
Edit → Project Settings → PhysicsのLayer Collision Matrixで、接触するColliderのGameObject同士のLayerが許可されているか確認します。親のLayerと子のColliderのLayerが同じとは限りません。Tagはゲーム側の識別用で、PhysicsのLayer判定とは別です。
Physics.IgnoreCollisionやIgnoreLayerCollisionを使う初期化・プール再利用処理も追います。Colliderが有効でも、無視設定によって対象の組が除外されている場合があります。無関係なLayerの設定を一括で変える前に、問題の2つのColliderだけで切り分けます。
3. 通知を受ける場所とメソッドを確認する
次は通知を記録するための短いコードです。TriggerProbe.csとして保存し、検査するTriggerのColliderと同じGameObjectに付けます。任意の親オブジェクトに置くだけで通知を受けるとは限りません。既存のTag判定やダメージ処理は一度外し、Consoleのフィルターも確認します。
using UnityEngine;
public sealed class TriggerProbe : MonoBehaviour
{
private void OnTriggerEnter(Collider other)
{
Debug.Log($"Trigger entered: {other.name}", this);
}
}
3Dでは引数はColliderです。2DのCollider2D・Rigidbody2Dは別の物理システムで、OnTriggerEnter2D(Collider2D other)を使います。3Dと2Dのコンポーネントを混ぜても、この3Dコールバックの条件にはなりません。
4. 物理シミュレーション中にゆっくり出入りさせる
再現用の単純なBoxとSphereで、Colliderが領域の外から内へ低速で入る状態を作ります。移動側のRigidbodyを使う移動処理を確認し、瞬間移動で薄い領域を飛び越えていないかも調べます。高速移動の見逃しは、Layerや受信先の不備とは分けて扱います。
GameObjectが有効でColliderが有効か、Rigidbody.detectCollisionsがfalseにされていないかを確認します。通知は物理シミュレーションで処理されるため、座標を代入した直後の同じ処理内で必ず発生する前提にはしません。ポーズや手動シミュレーションを使う場合は、物理のステップ自体が進んでいるか確認します。
修正後の確認
- 低速の外→内への移動で、条件分岐前のログが出ることを確認する。
Colliderの重なり・Layer・通知先を確認 - Layer設定とTag等のゲーム側判定を一つずつ戻す。
Colliderの重なり・Layer・通知先を確認 - 子Collider・複数Collider・プール再利用・対象端末で同じ条件を確認する。
Colliderの重なり・Layer・通知先を確認 - 複数Colliderによる複数通知を調べ、一度だけ実行したいゲーム処理は対象単位で管理する。
Colliderの重なり・Layer・通知先を確認
OnTriggerEnterは物体が入ったときの通知です。内部にいる間の継続処理はOnTriggerStay等と区別します。高速移動についてはすり抜けの切り分け記事も参照してください。
参考資料
- OnTriggerEnter: callbacks and physics simulation
- Introduction to collision: trigger requirements
- Interaction between collider types
- Layer-based collision detection
- Physics.IgnoreCollision
- Physics.IgnoreLayerCollision
- Collider.attachedRigidbody: parent body association
- Rigidbody.detectCollisions
- OnTriggerEnter2D: separate 2D callback