UE5 On Component Hit イベント完全解説｜物理衝突・Impact Normal・Hit Result

1On Component Hit とは

OnComponentHit は、物理シミュレーション中のコンポーネント (RigidBody) が他のオブジェクトと衝突した瞬間に呼ばれるイベントです。手榴弾の爆発、弾丸の命中、転がる物理オブジェクトの音再生など、衝突を契機としたゲームロジックの起点になります。

2イベント発火の前提条件

3Blueprint での使い方

1. Components → 物理シミュレーションする Mesh を選択
2. Details パネル右上の + Add Event → On Component Hit
3. Event Graph に新しいイベントノードが追加される
4. 必要に応じて Hit Result を分解して使用

4イベントの引数

5C++ で OnComponentHit にバインド

// Projectile.h
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "Projectile.generated.h"

UCLASS()
class MYGAME_API AProjectile : public AActor
{
    GENERATED_BODY()

public:
    AProjectile();

    UPROPERTY(VisibleAnywhere)
    UStaticMeshComponent* Mesh;

    UPROPERTY(EditAnywhere, Category = "Damage")
    float BaseDamage = 50.0f;

protected:
    virtual void BeginPlay() override;

    UFUNCTION()
    void OnHit(UPrimitiveComponent* HitComp,
               AActor* OtherActor,
               UPrimitiveComponent* OtherComp,
               FVector NormalImpulse,
               const FHitResult& Hit);
};

// Projectile.cpp
AProjectile::AProjectile()
{
    Mesh = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("Mesh"));
    RootComponent = Mesh;

    Mesh->SetSimulatePhysics(true);
    Mesh->SetNotifyRigidBodyCollision(true);  // ★ Hit Events 有効
    Mesh->SetCollisionProfileName(TEXT("PhysicsActor"));
}

void AProjectile::BeginPlay()
{
    Super::BeginPlay();
    Mesh->OnComponentHit.AddDynamic(this, &AProjectile::OnHit);
}

void AProjectile::OnHit(UPrimitiveComponent* HitComp,
                        AActor* OtherActor,
                        UPrimitiveComponent* OtherComp,
                        FVector NormalImpulse,
                        const FHitResult& Hit)
{
    if (!OtherActor || OtherActor == this) return;

    UE_LOG(LogTemp, Log, TEXT("Hit %s at %s, impulse=%s"),
        *OtherActor->GetName(),
        *Hit.ImpactPoint.ToString(),
        *NormalImpulse.ToString());

    // ダメージ計算 (運動量に比例)
    const float Damage = BaseDamage * (NormalImpulse.Size() / 10000.0f);
    UGameplayStatics::ApplyDamage(OtherActor, Damage, nullptr, this, nullptr);

    // 衝突パーティクル
    UGameplayStatics::SpawnEmitterAtLocation(
        GetWorld(), ImpactEffect, Hit.ImpactPoint, Hit.ImpactNormal.Rotation());

    // 自分は消滅
    Destroy();
}

6Hit Result の主要フィールド

7Notify Rigid Body Collision 設定の重要性

C++ では SetNotifyRigidBodyCollision(true)、Blueprint では Details → Collision → Simulation Generates Hit Events にチェックを入れないと、物理衝突しても OnComponentHit が呼ばれません。

// 動的に切替
Mesh->SetNotifyRigidBodyCollision(true);   // = bGenerateHitEvents = true
Mesh->BodyInstance.bNotifyRigidBodyCollision = true;  // 内部フラグ

8OnComponentHit vs OnActorHit

9Sweep Hit との違い

キャラ移動 (MoveComponent) や AddActorWorldOffset(Sweep=true) で動かしたときの衝突は、物理シミュレーションではなくスイープテストです。これも OnComponentHit を発火させるには NotifyRigidBodyCollision 相当の設定が必要です:

// Sweep 移動でも OnComponentHit を発火させる
FHitResult Hit;
SetActorLocation(NewLocation, /*bSweep=*/true, &Hit);

if (Hit.bBlockingHit)
{
    // 手動で同等の処理
    OnHit(GetRootComponent(),
          Hit.GetActor(),
          Hit.GetComponent(),
          FVector::ZeroVector,
          Hit);
}

10サンプル: 弾の命中処理

[Blueprint: BP_Bullet]

Event BeginPlay
  → Set Notify Rigid Body Collision (Mesh, true)

Event On Component Hit (Mesh)
  ├ Other Actor → Cast to BP_Enemy
  │   └ Apply Damage (Damage=20)
  │
  ├ Spawn Emitter At Location
  │   Template:  P_Impact
  │   Location:  Hit Result → Impact Point
  │   Rotation:  Hit Result → Impact Normal → Make Rot From X
  │
  ├ Spawn Sound At Location (Hit Result → Impact Point)
  │
  └ Destroy Actor (Self)

11サンプル: 衝突強度でダメージを変える

void AMyVehicle::OnHit(... FVector NormalImpulse, const FHitResult& Hit)
{
    const float Speed = GetVelocity().Size();         // cm/s
    const float ImpactMag = NormalImpulse.Size();

    // 5 m/s 未満は無視
    if (Speed < 500.0f) return;

    // ImpactMag が大きいほどダメージ
    const float Dmg = FMath::Clamp(ImpactMag / 5000.0f, 0.0f, 100.0f);

    if (AActor* Hit_ = Hit.GetActor())
    {
        UGameplayStatics::ApplyDamage(Hit_, Dmg, nullptr, this, nullptr);
    }

    // 物理マテリアルで音を変える
    if (Hit.PhysMaterial.IsValid())
    {
        UPhysicalMaterial* PM = Hit.PhysMaterial.Get();
        if (PM == MetalPhysMat)
            UGameplayStatics::PlaySoundAtLocation(this, MetalHitSound, Hit.ImpactPoint);
        else if (PM == WoodPhysMat)
            UGameplayStatics::PlaySoundAtLocation(this, WoodHitSound, Hit.ImpactPoint);
    }
}

12よくあるトラブル

13FAQ

Q: Projectile Movement Component の場合は？
A: UProjectileMovementComponent の OnProjectileBounce / OnProjectileStop イベントを使うのが一般的。OnComponentHit も併用可能。

Q: ImpactNormal が思った方向と違う
A: ImpactNormal は衝突面の法線（壁の向き）です。弾の進行方向と反対側を向きます。粒子効果の向きには Impact Normal をそのまま使うのが正解。

Q: マルチプレイで二重ダメージになる
A: OnComponentHit はサーバとクライアント両方で発火します。HasAuthority() でサーバ側だけで ApplyDamage を実行してください。