UE5第一人称射击游戏开发：从角色移动到AI追击的完整实践

简介这是一份UE5第一人称射击游戏开发实战教程适合具备一定UE5基础、希望系统掌握FPS核心玩法的初学者和中级程序员。PDF围绕完整开发流程展开先进行环境搭建与项目设置再依次实现第一人称视角、玩家移动与交互、射击与敌人AI、UI界面展示每一步都给出技术思路和可运行C片段例如玩家控制器与角色类的编写、增强输入映射等。资源包仅有1个PDF文件779KB体量紧凑但信息密度高。读者跟随章节边读边练可理解UE5动作游戏的项目组织方式掌握角色移动控制、射击判定、简单AI及HUD实现的具体做法最终独立搭建出一个带操作界面的FPS游戏原型。目前已有2198人学习下载适合作为日常练习与功能查漏的参考资料。1. 做 UE5 第一人称射击游戏先把这些默认项改掉如果你用 UE5 做第一人称射击游戏最省事的路线不是直接套第三人称模板而是把输入、相机、碰撞和动画链路在一个空项目里重新连一遍。第三人称模板里那套弹簧臂跟随逻辑转到第一人称后会变成不停占用你时间的干扰项。这个案例教程要带你把一条完整玩法链路走通角色移动和镜头控制、追踪式射击、能听枪声并主动追击的敌人 AI、动画重定向后的武器握持动作最后再用一组可复现的验证方法检查命中反馈和延迟。整个过程不依赖付费商城模板主要用 UE5 自带的 Enhanced Input、Line Trace、Behavior Tree 和 IK Retargeter指定角色和武器用少量 C 实现。这套改法适合刚学完 UE5 入门、想用一整个玩法验证实力的开发者也适合给策划做射击手感验证的原型工程。看完之后你再回到第三人称模板反而能看懂哪些地方要拆、哪些地方要留。2. 用 UE5 模板和 Enhanced Input 搭出第一人称角色移动层2.1 第三人称模板和自建 Pawn 的取舍直接修改 UE5 的第三人称模板是很多人一开始的选择但随后会绕进三个坑SpringArm 造成的镜头惯性、角色转身带动身体旋转、相机贴墙后退。第一人称射击游戏的摄像机一般挂在头部骨骼或角色根组件上让视角跟随 Controller 而不是跟随角色骨骼。我的做法是从Character子类新建FPSPlayerCharacter在构造函数里打开两个旋转开关bUseControllerRotationPitch true; bUseControllerRotationYaw true;注意不能打开bUseControllerRotationRoll第一人称镜头长期带 Roll 角会让人眩晕。打开这两个值的含义是视野方向完全由 Controller 维持角色动画层只做反馈不再负责朝向。很多第一人称射击项目都没把角色自转关干净导致射击时准心在命中判定里跑得比视觉快半拍。CharacterMovementComponent 里有一组值得在原型期就改掉的默认值我常用的参数参考如下参数默认值FPS 推荐作用Max Walk Speed600600~750决定走路和冲刺的基础移速Max Acceleration20482048~4096越大响应越快急转身更跟手Braking Deceleration20484096松开键位的减速强度Air Control0.050.3~0.5空中转向手感跳跃射击时需要Ground Friction88~12配合刹车调整起步惯性修改位置在构造函数或BeginPlay均可。单人原型直接在构造函数写最简单后续如果项目要开放网络同步移动相关属性要交给服务器侧统一更新不能在客户端只改本机数值。2.2 Enhanced Input 的动作映射怎么组织战斗键位UE5 默认推荐 Enhanced Input替代旧版 InputAxis。第一人称射击至少需要三组 InputActionMove2D 向量、Look2D 向量、Attack布尔。Attack 单独拆成一个动作因为开火和松开都要监听用于半自动和按住连发切换。右键新建 Input Action 后在编辑器的 Mapping Context 里把 WASD、鼠标移动、鼠标左键放进同一组。鼠标上下移动记得开启 Y 轴反转否则很多从主机转过来的玩家第一反应就会觉得镜头反向。绑定 C 代码如下void AFPPlayerCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent) { if (UEnhancedInputComponent* EIC CastUEnhancedInputComponent(PlayerInputComponent)) { EIC-BindAction(MoveAction, ETriggerEvent::Triggered, this, AFPPlayerCharacter::Move); EIC-BindAction(LookAction, ETriggerEvent::Triggered, this, AFPPlayerCharacter::Look); EIC-BindAction(AttackAction, ETriggerEvent::Started, this, AFPPlayerCharacter::StartAttack); EIC-BindAction(AttackAction, ETriggerEvent::Completed, this, AFPPlayerCharacter::StopAttack); } }这里的关键是Triggered而不是Started。Move 和 Look 需要每一帧持续读取当前输入值Triggered会在动作保持触发时持续回调Started只在按键按下瞬间触发一次。Attack 动作绑定Started和Completed这样半自动武器点一下就停全自动武器按住时在 Tick 里检测bIsFiring即可持续射击。Move的实现要特别注意方向来源void AFPPlayerCharacter::Move(const FInputActionValue Value) { FVector2D Axis Value.GetFVector2D(); AddMovementInput(UKismetMathLibrary::GetForwardVector(GetControlRotation()), Axis.X); AddMovementInput(UKismetMathLibrary::GetRightVector(GetControlRotation()), Axis.Y); }这里必须用GetControlRotation()如果写成GetActorRotation()玩家转动视角后角色仍然按初始朝向移动转头越大幅度方向偏差越大。第一人称射击的移动方向永远由当前相机朝向决定这是一个看似基础但最容易出错的地方。移动端调试时还要考虑双指触摸蓝图那类输入布局左半屏触发 MoveAction右半屏触发 LookAction 和 AttackAction。Enhanced Input 的多指识别在 Mapping Context 的修饰器里按 Finger 索引区分触点如果不区分两指触控会被系统按触摸顺序分配容易出现滑动手势抢镜头的漂移问题。2.3 冲刺和视角 FOV 联动怎么做射击游戏常用冲刺时拉大 FOV 来制造速度感。常见做法是维护一个 FOV 目标值默认 90冲刺时改成 104再用FInterpTo做平滑过渡float TargetFOV bWantsToSprint ? SprintFOV : BaseFOV; CurrentFOV FMath::FInterpTo(CurrentFOV, TargetFOV, DeltaSeconds, 8.f); GetCameraComponent()-SetFieldOfView(CurrentFOV);插值速度从 8 起步。调慢了没有冲刺反馈调快了容易发晕。注意到这里每一帧都在调用 SetFieldOfView所以应该加一个小于 0.1 度的差值判断数值不变时跳过写入。这个细节在移动端和低端 PC 上能省下不少内部状态更新开销。3. 用 Line Trace 实现 UE5 的第一人称射击命中判定3.1 Hitscan 和 Projectile 的选型射击命中判定要先决定武器模型。Hitscan 扫描和 Projectile 投射物的差别会直接影响网络同步、射击手感和性能预算维度Hitscan 扫描Projectile 投射物命中时刻开火瞬间飞行一段时间后网络同步延迟补偿和命中通知更简单需要插值和服务器回滚性能一次通道检测多次碰撞和物理计算典型武器步枪、手枪火箭筒、榴弹发射器第一人称射击游戏的核心手感和“开火后立刻看到命中反馈”强相关。飞行时间再短也会让拉枪瞬间感觉慢半拍。大多数项目的主武器都优先做 Hitscan需要弹道下坠的武器再单独实现投射物。原型阶段我一般只写一个 Hitscan 接口预留武器基类等玩法确认需要抛物线武器时再扩展。3.2 从相机发射 Trace 还是从枪口发射很多新手第一版从枪口静态组件发射射线结果看到弹着点明显偏离准心尤其贴墙时枪口埋进墙体子弹直接打在地上。正确的做法是从 Camera 视线起点发射枪口只作为特效显示位置。这样准心指向哪里子弹就命中哪里。FHitResult AFPPlayerCharacter::FireHitScan() { FVector CameraLoc; FRotator CameraRot; GetActorEyesViewPoint(CameraLoc, CameraRot); FVector ShotDir CameraRot.Vector(); FVector TraceEnd CameraLoc ShotDir * FireDistance; FCollisionQueryParams Params; Params.AddIgnoredActor(this); Params.bReturnPhysicalMaterial true; FHitResult Hit; GetWorld()-LineTraceSingleByChannel(Hit, CameraLoc, TraceEnd, ECC_Visibility, Params); return Hit; }AddIgnoredActor(this)是这串逻辑里的保命键。如果不忽略自己射线会命中角色胶囊体枪械永远打不出去。bReturnPhysicalMaterial打开后命中金属、木头、血肉时能拿到不同的 PhysicalMaterial后续接脚步声和弹孔材质反馈都靠它。还要处理枪口视角遮挡的问题。如果只从相机发射贴墙时会出现枪管穿墙但命中点还在墙外的穿模感。我一般会在开火前多打一次相机到枪口位置的短距离 Trace检测到墙就把枪口特效移到墙面附近视觉和命中点才不会互相拆台。3.3 散射、后坐力与命中反馈无扩散的 Hitscan 会让全自动武器显得过于精准所以腰射时要加随机散射。散射量通常和移动速度、连射次数挂钩float SpreadDeg FMath::Clamp(BaseSpread FMath::Abs(GetVelocity().Size()) * VelocitySpreadFactor, MinSpread, MaxSpread); FVector2D RandomOffset FMath::RandUnitVector() * SpreadDeg; ShotDir (ShotDir CameraRot.Vector() * RandomOffset.X CameraRot.RightVector() * RandomOffset.Y).GetSafeNormal();FMath::RandUnitVector返回的是圆盘内均匀分布的随机点比两个独立随机浮点数组合更均匀。准心扩散范围要限制在MinSpread和MaxSpread之间否则移动中射击的弹道会散得完全看不懂。后坐力不建议直接在一帧里调AddControllerPitchInput那样会把视角永久抬高一截玩家还得手动拉回来。常见做法是播放一段很短的 CameraShake让镜头先向上推再回中这类效果可以用UCameraShakeBase的 Oscillation 参数完成不污染输入轴也不会被跳跃状态打断。枪口火光和命中反馈放到武器动画蒙太奇里指定帧的山级事件触发什么时候冒出火花、什么时候播放弹孔音效都以这个 Notify 位置为准。3.4 命中目标后的通用接口设计武器命中后不要直接依赖敌人类型。定义一个IDamageableInterface所有能被子弹打中的角色或物资产实它if (Hit.GetActor() Hit.GetActor()-GetClass()-ImplementsInterface(UDamageableInterface::StaticClass())) { IDamageableInterface* Target CastIDamageableInterface(Hit.GetActor()); Target-ApplyDamage(CurrentWeaponDamage, this, GetController(), Hit.Location); }这样比CastAEnemyBase通用得多。后面加木箱、靶子、油桶都只需要实现同一个接口武器侧不用反复加分支。敌人体内的血量和死亡逻辑各自维护武器只负责传出“谁打的、在哪打的、打了多少”这三个信息。4. 用 UE5 的 Behavior Tree 和感知事件给敌人 AI 做还手能力4.1 AI Controller 与 Behavior Tree 的最小组合用 UE5 做 NPC AI Agent 的开发方式和后端智能体不同这里更看重帧级响应。感知、决策、行动三步需要在几十毫秒内完成Behavior Tree 的天然事件驱动特性正好合适它不会每帧跑完整棵树。创建敌人角色后在它的AIControllerClass指定一个自定义 AIController重写OnPossess并运行行为树void AFPSEnemyController::OnPossess(APawn* InPawn) { Super::OnPossess(InPawn); if (UBehaviorTree* BT LoadObjectUBehaviorTree(nullptr, TEXT(/Game/AI/BT_FPSEnemy.BT_FPSEnemy))) { RunBehaviorTree(BT); } }RunBehaviorTree返回 false 的常见原因是关卡里没有烘焙 NavMesh。我在这种情况下会先检查 P 键呼出的 Navigation 显示看敌人脚下是否出现绿格子。路径写死用LoadObject只适合原型验证正式工程请把 BehaviorTree 资产以引用变量暴露在蓝图中避免资产路径变更后找不到。行为树结构我通常这样组织FPSEnemyBT ├─ Combat (Selector) │ ├─ AttackPlayer (Sequence, 条件: 在视野和射程内) │ │ ├─ Set Focus (黑板变量) │ │ ├─ Task PlayMontage (射击动作) │ │ └─ Wait 0.5 (射击硬直) │ └─ MoveToPlayer (Task MoveTo, 目标黑板变量) ├─ Investigate (Sequence, 条件: 听到枪声) │ └─ MoveToNoiseLocation (黑板变量) └─ Patrol └─ MoveToRandomPoint (Task FindPatrolLocation)Selector从上往下试一旦某个分支条件满足后面的巡逻分支就不会执行。这里最值得调的是MoveTo的 AcceptanceRadius。设成 10 敌人会抖着找目标设成 250 又会在远处左右滑步。一般持枪距离 1500 时我会把这个半径放在 120~200 之间敌人既能站定射击又不会在目标周围来回抽动。4.2 利用多播委托传递枪声让 AI 的听觉感知联动敌人知道玩家在哪不能靠玩家主动告诉敌人这样太作弊。常见做法是武器开火时广播一个声源位置AI 的感知系统把它当刺激处理。UE5 多播委托正好可以当轻量级事件总线用。在武器基类里声明一个双参数多播委托DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FWeaponFiredEvent, FVector, FireLocation, float, Volume); UCLASS() class AFPSWeaponBase : public AActor { GENERATED_BODY() public: UPROPERTY(BlueprintAssignable, Category Weapon|Event) FWeaponFiredEvent OnWeaponFired; };开火后调用OnWeaponFired.Broadcast(FireLocation, 1.0f);。广播点不要直接用角色位置第一人称武器枪口在相机附近声源如果放在玩家身体中心AI 会按玩家整个胶囊体判断方向。把枪口世界位置传出去听觉感知才有方位感。敌人 AI Controller 在初始化时绑定事件Weapon-OnWeaponFired.AddDynamic(this, AFPSEnemyController::OnGlobalShootEvent);AI Perception 组件里开启AISense_Hearing即可接收到这类刺激。感知回调会更新黑板里的 LastNoiseLocation行为树的 Investigate 分支读取这个位置执行 MoveTo。多播委托的绑定生命周期要注意敌人销毁时如果回调还挂在事件上下次开火就会访问到已经标记的 Pawn。所以在OnUnPossess里统一调用一次RemoveDynamic避免 PIE 环境下出现幽灵回调。4.3 受击反馈和死亡掉落敌人的受击反馈不能只依赖动画蒙太奇。AI 控制角色在行为树里持续执行 MoveTo 时播放受伤动画会被下一个移动指令打断。常见做法是受击时强制切到受击分支GetCharacterMovement()-MaxWalkSpeed 150.f; PlayAnimMontage(HitReactMontage); GetWorld()-GetTimerManager().SetTimer(RecoverTimer, [this]() { GetCharacterMovement()-MaxWalkSpeed OriginalSpeed; }, 0.6f, false);受击瞬间把移动速度压到 150播放短促的 HitReact0.6 秒内恢复。这样既有被打断的感觉又不会让敌人卡在原地不追玩家。死亡先不急着开 Ragdoll。把胶囊体碰撞保留关掉移动输入播放一段死亡动画延迟几秒再禁 Tick。直接启用物理布娃娃会让 AI 的 NavMesh 和感知在物理帧里重新计算低端机容易卡顿等玩法稳定后再换效果不迟。5. UE5 动画重定向与武器握持的关键设置5.1 用 IK Retargeter 把可用骨骼动画搬到自定义角色上第一人称射击游戏里敌人和玩家的武器动画大多来自商店或动捕资源骨骼命名不一定和当前角色匹配。UE5 的 IK Retargeter 流程分三步在角色骨骼资产上创建 IK Rig定义骨盆、脊柱、手臂、腿部骨骼链再创建 IK Retargeter 指定源骨骼和目标骨骼。重定向完最常见的问题就是脚部悬空或者手臂划大圈。我一般先检查三处骨盆映射是否指向 pelvis膝盖的 Pole Vector 是否朝前脚部骨骼有没有开 Foot Lock。下面是几个高频参数Retarget 参数作用常见应用范围Twist Axis纠正手臂旋转的轴向按目标骨架 Z 或 X 轴微调Pole Vector保持膝盖朝向避免膝盖旋转过头0.4~0.7Retarget Root根节点位移的平顺度模型差异大时用 0.1~0.3Foot Lock修正脚掌接触地面的滑步开动画急停时明显改善第一人称手臂动画不要直接复用第三人称全骨骼重定向因为第一人称镜头下的手臂参考高度和枪械锚点都和第三人称不同。我更建议单独建一个第一人称手臂骨骼只保留手部和前臂动画枪械作为手臂骨骼上的子组件挂在上面这样切换第一人称时不会把全身骨骼带进镜头。5.2 AnimBP 槽位让开火和换弹互不打断第一人称和第三人称的 AnimBP 都要处理同一件事角色在奔跑时换弹或开火不希望整条动画被替换。UE5 的 Slot 节点专门解决这种分层混合需求。在 AnimBP 的 AnimGraph 里加一个 Slot 节点给它一个比如 UpperBody 的 SlotName。开火和换弹的 AnimMontage 播放时指定到这个 Slot底层 Locomotion 仍然在跑上层动画按过渡时间混合进去。C 里播放换弹蒙太奇时只需要一行UAnimInstance* Anim GetMesh()-GetAnimInstance(); if (Anim ReloadMontage) { Anim-Montage_Play(ReloadMontage, 1.f, EMontagePlayReturnType::MontageLength, 0.f, false); }蒙太奇资产里的 SlotName 必须和 AnimBP 里的 Slot 名称一致否则动画会在默认层播放效果变成全身切换。第一人称开火蒙太奇不要开 Root Motion第一人称视角下根动画会造成镜头来回晃而且实际位移不被移动组件认可射击时角色会莫名滑步。5.3 枪口特效和材质里的 Panner 用法Panner 是材质里常用的 UV 平移节点做枪口火焰贴图滚动很合适。在材质编辑里把火焰贴图的 TexCoord 输入前接一个 PannerSpeed 节点分成 X 和 Y 两个输入X 为 0、Y 为 1 表示火焰向上滚动调大数值会使贴图滚动变快。火焰质感主要在自发光强度。把噪声贴图连到 Emissive Color乘以一个较大倍率再配合 Niagara 粒子里的半透明混合枪口才会有烧起来的感觉。如果 Panner 用在贴花或 UI 上边缘会显示出明显的方片要额外乘 OpacityMask 做透明度裁剪。武器握把位置如果对齐不了优先调整手型动画其次是枪械骨骼上的辅助 IK。许多第一人称射击案例败在模型漂亮但手穿模。碰到这类问题我一般会在枪械骨骼加两个 Two Bone IK 目标点在右手和左手分别做瞄准约束比逐帧手调动画快得多。6. 交付前的联调用 TraceDebug 和 stat 命令验证第一人称射击手感6.1 把命中轨迹和伤害事件都打出来很多手感问题都出在“看起来打到却没有伤害反馈”。因为 Trace 起终点和视觉方向之间只要偏离一两个像素远距离就会差出半个身位。建议在 FireHitScan 前面加一个调试条件只在 PIE 模式里绘制射线和命中点#if WITH_EDITOR if (bDrawDebugTrace GetWorld()-WorldType EWorldType::PIE) { DrawDebugLine(GetWorld(), CameraLoc, TraceEnd, FColor::Yellow, false, 0.2f, 0, 1.0f); if (Hit.bBlockingHit) { DrawDebugPoint(GetWorld(), Hit.Location, 8.f, FColor::Red, false, 0.2f); } } #endif红点表示实际命中位置弹孔中心应该和红点重叠。如果红点在角色胶囊体上多半是AddIgnoredActor(this)没生效或者第一人称武器子组件也被算进了命中对象。再打开bTraceComplex用复杂碰撞检测能看到更细的骨头结构但物理查询开销会变大正式版本记得关掉。6.2 用 stat 命令把资源压力先隔离手感卡顿和输入延迟通常由性能问题伪装。在编辑器按波浪号打开控制台输入三条命令组合判断stat fps看实时帧率确认是否低于目标刷新率。stat unit看 Game/Thread/GPU 三项耗时哪一项标红就优先查哪一项。stat SceneRendering看 DrawCall 是否被枪口特效拖垮。第一人称枪械的 Niagara 粒子如果常驻发射敌人一多 DrawCall 会高出很多。我一般会把枪口特效组件在开火时瞬间触发不开火时隐藏只保留一个极短生命周期的粒子系统。这个改动通常能让stat unit的 GPU 耗时明显下降。移动端还要回到真机跑一遍双指触摸蓝图的输入布局不能只在 PIE 预览器里验证真机上触摸事件分派比编辑器更接近硬件延迟至少跑三十分钟再看触点复用是否漂移。6.3 给玩家一个快速手感验证流程FPS 手感最终要人来测但流程可以固化。站在距离一排标靶 1500 单位的位置快速点射十发观察准星跳动是否超过两个像素移动中射击十发观察命中反馈是否比开火晚两帧以上再让一个敌人 AI 触发枪声听觉记录它在听到枪声后一秒内能不能到达警戒位置。如果反馈晚过两帧优先检查动画蒙太奇里的 Notify 帧位置把枪口火光和枪声统一挪到扳机按下的同一帧再去调 CameraShake 振幅。这个验证场景提前摆好之后每换一把新枪、每加一种怪物先跑一遍这一套流程比反复靠手感猜原因要可靠得多。本文还有配套的精品资源点击获取