游戏引擎 / 系统课时
处理触发器与区域事件
处理触发器与区域事件
这一课用一个可复用的 Trigger Actor 处理角色进入、离开和一次性机关触发。重点不是“碰到就执行代码”,而是把碰撞过滤、Overlap 事件和机关逻辑分开,这样区域事件才不会因为多余组件或重复进入而失控。
学习目标
- 配置只参与查询的 Trigger 碰撞体并接收 Begin/End Overlap
- 对进入对象做过滤,避免无关 Actor 触发机关
- 实现可重复区域与一次性区域,并能定位重复触发或完全不触发的问题
把触发区域当作传感器
Trigger 最适合承担“谁进入了某个空间”的感知职责,而不是直接充当实体墙。一个常用配置是让 UBoxComponent 使用 QueryOnly,忽略所有通道,只把 Pawn 设置为 Overlap,并开启 Generate Overlap Events。这样玩家可以穿过区域,但进入和离开边界时会产生事件。

触发事件能否产生取决于两边的碰撞设置。Trigger 自己开启 Overlap 还不够;参与重叠的另一个 Primitive Component 也必须允许生成 Overlap 事件。对于标准 Character,通常由 Capsule Component 承担这项职责。
用一个Actor处理进入和离开
下面创建一个带 UBoxComponent 的区域 Actor。它只监听 Pawn 通道,在首次进入时记录一次状态;当 bTriggerOnce 为 true 时,之后的再次进入会被忽略,但离开事件仍然可以正常到达。
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "ZoneTrigger.generated.h"
class UBoxComponent;
class UPrimitiveComponent;
UCLASS()
class AZoneTrigger : public AActor
{
GENERATED_BODY()
public:
AZoneTrigger();
protected:
virtual void BeginPlay() override;
UPROPERTY(VisibleAnywhere)
TObjectPtr<UBoxComponent> Trigger;
UPROPERTY(EditAnywhere, Category = "Trigger")
bool bTriggerOnce = false;
bool bConsumed = false;
UFUNCTION()
void OnTriggerBegin(
UPrimitiveComponent* OverlappedComponent,
AActor* OtherActor,
UPrimitiveComponent* OtherComp,
int32 OtherBodyIndex,
bool bFromSweep,
const FHitResult& SweepResult
);
UFUNCTION()
void OnTriggerEnd(
UPrimitiveComponent* OverlappedComponent,
AActor* OtherActor,
UPrimitiveComponent* OtherComp,
int32 OtherBodyIndex
);
};#include "ZoneTrigger.h"
#include "Components/BoxComponent.h"
#include "GameFramework/Pawn.h"
AZoneTrigger::AZoneTrigger()
{
Trigger = CreateDefaultSubobject<UBoxComponent>(TEXT("Trigger"));
RootComponent = Trigger;
Trigger->SetBoxExtent(FVector(150.0f, 150.0f, 100.0f));
Trigger->SetCollisionEnabled(ECollisionEnabled::QueryOnly);
Trigger->SetCollisionResponseToAllChannels(ECR_Ignore);
Trigger->SetCollisionResponseToChannel(ECC_Pawn, ECR_Overlap);
Trigger->SetGenerateOverlapEvents(true);
}
void AZoneTrigger::BeginPlay()
{
Super::BeginPlay();
Trigger->OnComponentBeginOverlap.AddDynamic(
this,
&AZoneTrigger::OnTriggerBegin
);
Trigger->OnComponentEndOverlap.AddDynamic(
this,
&AZoneTrigger::OnTriggerEnd
);
}
void AZoneTrigger::OnTriggerBegin(
UPrimitiveComponent* OverlappedComponent,
AActor* OtherActor,
UPrimitiveComponent* OtherComp,
int32 OtherBodyIndex,
bool bFromSweep,
const FHitResult& SweepResult
)
{
if (!OtherActor || !OtherActor->IsA<APawn>())
{
return;
}
if (bTriggerOnce && bConsumed)
{
return;
}
bConsumed = true;
UE_LOG(LogTemp, Display, TEXT("Zone entered by Pawn"));
}
void AZoneTrigger::OnTriggerEnd(
UPrimitiveComponent* OverlappedComponent,
AActor* OtherActor,
UPrimitiveComponent* OtherComp,
int32 OtherBodyIndex
)
{
if (!OtherActor || !OtherActor->IsA<APawn>())
{
return;
}
UE_LOG(LogTemp, Display, TEXT("Zone exited by Pawn"));
}预期输出:把 AZoneTrigger 放进关卡,让玩家完整穿过盒体一次,Output Log 应依次出现:
LogTemp: Display: Zone entered by Pawn
LogTemp: Display: Zone exited by Pawn如果 bTriggerOnce 为 true,玩家第二次进入时不会再出现 Zone entered by Pawn。如果希望区域每次都执行进入逻辑,把它保持为 false。
把机关动作和传感器分开
示例中的 UE_LOG 是最小验证点。实际项目里,Trigger 更适合发出“区域被进入”这一事实,再由门、灯、任务系统或关卡脚本决定怎么响应。这样同一个 Trigger 可以复用于开门、播放音效、切换战斗区域等不同场景。
需要“进入时开启、离开时关闭”的机关时,把开启逻辑放在 Begin Overlap,把关闭逻辑放在 End Overlap。需要一次性机关时,只在 Begin Overlap 使用 bConsumed 做门闩,不要立刻关闭 Generate Overlap Events,否则当前角色可能收不到对应的 End Overlap。
排查不触发和重复触发
完全不触发时,先检查 Trigger 与角色碰撞组件是否都开启 Generate Overlap Events,再确认双方的碰撞响应组合最终是 Overlap,而不是 Ignore 或 Block。如果角色一开始就出生在 Trigger 内,Begin Overlap 在关卡启动阶段出现属于有效情况,不应当按“玩家刚跨过边界”理解。
重复触发通常来自两个来源:角色上不止一个 Primitive Component 能与 Trigger 重叠,或者机关逻辑本身没有幂等保护。单玩家、单 Capsule 的简单关卡可以直接使用上面的实现;多人或多个对象同时进入同一区域时,应把“谁正在区域内”记录成 Actor 集合,而不是用单个布尔值代表整个区域。
当区域事件同时具备明确的碰撞过滤、进入与离开成对处理,以及一次性逻辑的门闩状态后,机关行为会比“所有逻辑都塞进 BeginOverlap”更容易扩展和排错。