应直接继承Character而非Actor创建玩家角色,因其已封装移动组件、碰撞体、动画接口及网络同步能力;从Actor派生需重复实现整套系统,易出错且效率低。

在Unreal Engine中,用C++构建玩家角色的核心实体,关键不是“选Actor还是Character”,而是理解它们的定位与协作关系:Character是专为带移动、碰撞、动画能力的玩家/敌人设计的Actor子类,而Actor是所有可放置对象的基类。直接继承Character才是标准做法。
为什么不该从Actor开始写玩家类
Actor本身不带移动组件(如UCharacterMovementComponent)、不支持网络同步移动、没有内置的CapsuleCollider、也不提供GetVelocity()、Launch()、AddMovementInput()等角色行为接口。若硬从Actor派生,你得手动添加移动组件、重写Tick逻辑、自行处理地面检测、斜坡滑动、跳跃力计算——等于重复实现Character已封装好的整套物理与输入响应系统。
常见误区示例:
- 新建MyPlayerActor : public AActor → 编译能过,但无法调用Jump()或使用蓝图中的“Character Movement”节点
- 手动AddComponent
() → 组件存在,但未初始化、未绑定到RootComponent,移动仍无效 - 忽略Collision Presets → Capsule未设为Pawn,导致无法阻挡其他Pawn或被射线检测命中
正确创建玩家角色类的三步落地流程
以UE5.3+ C++为例,推荐在编辑器中通过“New C++ Class”向导创建,父类选Character:
立即学习“C++免费学习笔记(深入)”;
- 命名与生成:类名建议用MyPlayerCharacter(避免PlayerCharacter,防与引擎类冲突),勾选“Add to Project”,生成后自动注册到GameMode默认PawnClass
-
头文件精简声明:在MyPlayerCharacter.h中仅暴露必要变量和函数,例如:
// 不要在这里定义UCharacterMovementComponent*,它已在父类中存在 UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Movement") UCapsuleComponent* GetCapsuleComponent() const { return CapsuleComponent; }UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Camera") USpringArmComponent* CameraBoom;UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Camera") UCameraComponent* FollowCamera; -
构造函数里配置组件:在MyPlayerCharacter.cpp的构造函数中完成初始化:
AMyPlayerCharacter::AMyPlayerCharacter() { PrimaryActorTick.bCanEverTick = true;CameraBoom = CreateDefaultSubobject(TEXT("CameraBoom")); CameraBoom->SetupAttachment(RootComponent); CameraBoom->TargetArmLength = 400.f; CameraBoom->bUsePawnControlRotation = true; FollowCamera = CreateDefaultSubobject (TEXT("FollowCamera")); FollowCamera->SetupAttachment(CameraBoom, USpringArmComponent::SocketName); GetCharacterMovement()->bOrientRotationToMovement = true; GetCharacterMovement()->RotationRate = FRotator(0.f, 500.f, 0.f); GetCharacterMovement()->JumpZVelocity = 700.f; GetCharacterMovement()->AirControl = 0.35f;}
关键逻辑必须覆写的函数
Character类已预置了输入响应骨架,只需按需重写,无需接管整个Tick循环:
- SetupPlayerInputComponent():绑定输入轴映射(MoveForward/MoveRight/LookUp/Turn),这是唯一需要显式调用Parent::SetupPlayerInputComponent的函数
- BeginPlay():适合加载数据、检查网络角色状态(如IsLocallyControlled())、启动UI Widget
- Tick():仅放真正需要每帧更新的逻辑,如自定义状态机切换、技能冷却计时;常规移动、跳跃由CharacterMovement自动处理
- NotifyHit() / Landed() / OnMovementModeChanged():用于响应物理事件,比如落地播放音效、进入游泳模式时切换材质
网络同步与角色复用要点
多人游戏中,Character天然适配UE的Replication机制:
- 确保变量加UPROPERTY(Replicated)并调用GetWorld()->GetNetMode() != NM_DedicatedServer时才执行客户端逻辑
- 移动相关属性(Location/Rotation/Velocity)由CharacterMovement自动同步,无需手动复制
- 若需自定义RPC,优先用Server_开头的函数(如Server_FireWeapon),并在客户端调用前校验HasAuthority()
- 非玩家NPC也建议继承Character而非Actor——即使不控制,也能复用碰撞、移动、动画蓝图接口,便于后期扩展AI行为










