UE5.3 C++ ARPG 游戏开发：创建角色类

UE5.3 C++ ARPG 游戏开发：创建角色类

资产准备

在资源库中找到'Windwalker Echo'，点击创建项目。打开下载的工程，将 EchoContent 整体迁移到当前工程中。

创建 Character 类

新建 C++ 类，选择'角色'类型，命名为'SlashCharacter'。 创建基于'SlashCharacter'的蓝图类，命名为'BP_SlashCharacter'。 打开'BP_SlashCharacter'，设置骨骼网格体资产为'Echo'，调整位置和旋转。 创建游戏模式，设置默认 Pawn 类为'BP_SlashCharacter'。

通过增强输入控制角色

在'EchoContent'中查找输入资产。该资源包采用'模拟旧版输入系统'的增强输入写法，将前后和左右拆分成了两个独立的资产：IA_MoveForward（前后）和 IA_MoveRight（左右）。视角也拆分成了 IA_Turn（左右看）和 IA_LookUp（上下看）。

在'SlashCharacter.h'中添加头文件、声明组件、声明输入变量和对应的回调函数。 在'SlashCharacter.cpp'中引入必要的头文件，添加组件，在游戏开始时激活映射上下文，实现回调函数。 打开'BP_SlashCharacter'，取消勾选'使用控制器旋转 Yaw'，让角色身体独立于视角。 选中弹簧臂组件，勾选'使用 Pawn 控制旋转'，使弹簧臂跟着鼠标转。 选中角色移动组件，勾选'将旋转朝向运动'，此时角色在前进时就会自动将身体朝向视角方向。

给角色添加毛发

打开.Build.cs，添加'HairStrandsCore'和'Niagara'模块，重新生成 VS 项目文件。 Ctrl+Shift+B 重新编译解决方案，关闭 Visual Studio。删除 Saved、Intermediate 目录。 右键点击重新生成 VS 文件，双击.uproject 文件，选择 Yes 进行 rebuild。 关闭 UEEditor，打开 Visual Studio。在'SlashCharacter.h'声明两个毛发组件变量。 在'SlashCharacter.cpp'中引入必要的头文件，创建两个毛发组件分别是头发和眉毛，附加到网格体上。 在项目设置中勾选'支持蒙皮缓存'。 编译后打开'BP_SlashCharacter'，设置 GroomAsset。

动画蓝图（站立、跑）

新建一个动画蓝图，骨骼使用'Echo_Skeleton'，命名为'ABP_SlashCharacter'。 打开'ABP_SlashCharacter'，在事件图表中获取角色和角色移动组件的引用，逐帧获取角色的移动速度。 在动画图表中新增一个状态机，命名为'GroundLocomotion'。 打开'GroundLocomotion'，添加站立和跑步两种状态及其转换规则。 站立和跑步状态分别输出对应姿势，注意设置循环动画。 设置状态切换的规则。 在'BP_SlashCharacter'中使用动画蓝图。

C++ 创建动画实例

新建 C++ 类，父类选择'AnimInstance'，命名为'SlashAnimInstance'。 删除动画蓝图中事件图表的所有节点和变量，我们准备在 C++ 中获取'BP_SlashCharacter'及其角色移动组件的引用，动画蓝图只保留'GroundSpeed'。 在'SlashAnimInstance.h'中重写父类中的初始化函数'NativeInitializeAnimation'，这个函数通常在动画实例被创建或初始化时只执行一次，用于初始化变量或获取其他组件的引用。 继续重写父类的 NativeUpdateAnimation 函数，对应于动画蓝图中的 Event Blueprint Update Animation 节点。这是动画实例的 Tick 函数，每一帧都会执行，核心目的是把游戏角色的状态同步给动画蓝图。 声明成员变量 SlashCharacter, SlashCharacterMovement, GroundSpeed, IsFalling。 在'SlashAnimInstance.cpp'中引入必要的头文件。 在 NativeInitializeAnimation 函数中获取动画实例的 Pawn 拥有者，转换为 ASlashCharacter 类型，从而获取 SlashCharacter 的引用，进而获取其角色移动组件的引用。 在 NativeUpdateAnimation 函数中实时更新角色的移动速度。 编译后，打开动画蓝图'ABP_Echo'，将该动画蓝图的父类设置为用 C++ 编写的动画实例'SlashAnimInstance'。 重设父类后，由于虚幻引擎防止变量重名，会自动修改蓝图中变量名。删除之前蓝图中创建的'GroundSpeed'变量，并将转换规则中涉及到的变量进行替换。 可以通过勾选'显示继承的变量'来显示我们在 C++ 中创建的变量。

动画蓝图（跳）

在动画实例头文件中声明变量。 在动画蓝图更新时获取角色是否处于下落状态。 编译后可以看到此时动画蓝图中出现变量'IsFalling'可以用于判断角色状态。 在动画蓝图'ABP_SlashCharacter'中，将先前状态机'GroundLocomotion'输出的姿势存起来，然后新建一个状态机'MainState'。 在'MainState'中添加'OnGround'、'InAir'和'Land'三个状态。 在状态'OnGround'中使用之前存的'Cache_GroundLocomotion'。 'InAir'状态使用起跳的动画序列。 'Land'状态使用下落的动画序列，注意要取消循环动画。 当'IsFalling'为 True 时，让角色状态由'OnGround'转为'InAir'，表示起跳。 当'IsFalling'由 True 变为 False 时让角色状态由'InAir'转为'Land'，表示落地。 当落地动画播放完成自动将状态由'Land'转为'OnGround'。 由于落地动画时间较长，增加一个转换规则。如果玩家落地后立即开始移动，不要播放完整的落地缓冲动画，只播放前 0.2 秒，然后迅速切换到跑步状态。 为了防止玩家多次原地起跳，需要增加'Land'到'InAir'的规则。规则就是'IsFalling'为 True，这样一来，无论落地动画播了多少，只要系统检测到角色在空中按下空格键导致 CharacterMovement 进入 Falling 模式，动画蓝图就会无视落地动作，瞬间切换到跳跃/空中动作。 在'SlashCharacter.h'中添加跳跃的 Input Action 变量，这里不需要像 MoveForward 那样声明一个新的 void Jump(const FInputActionValue& Value) 函数，因为我们要直接使用父类 ACharacter 自带的 Jump 函数实现角色跳跃。 在'SlashCharacter.cpp'中绑定输入。 新增一个输入操作资产，命名为'IA_Jump'。 在输入映射上下文中增加一个映射，按键设置为空格键。 在'BP_SlashCharacter'中设置 Jump Action。