C++ UE游戏角色系统_C++怎么用Actor和Character构建核心玩家实体

应直接继承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：

• 命名与生成：类名建议用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行为