游戏引擎 / 系统课时
用Data Asset管理配置
用Data Asset管理配置
当武器伤害、角色速度、关卡规则直接写进 Gameplay 类时,调参会变成改代码、重新编译和反复查找常量。本节用 UE5 Data Asset 把静态配置提取成资源,让代码负责行为,让资源负责可编辑数据。
学习目标
- 能用
UPrimaryDataAsset定义武器等可复用配置 - 能区分静态配置、运行时状态和资源引用
- 能让 Gameplay 类只读取配置,而不是把数值散落在代码中
把稳定结构定义成 Data Asset
适合放进 Data Asset 的内容,是“结构稳定但数值经常调整”的数据,例如武器基础伤害、射击间隔、角色移动参数、关卡推荐难度和资源引用。它们不应保存当前生命值、剩余弹药这类会在运行时持续变化的状态。
下面是片段示例,依赖一个启用了 C++ 的 UE5 项目。它定义可在编辑器中创建资源实例的武器配置类型;UPrimaryDataAsset 还能与 Asset Manager 的 Primary Asset 体系配合,但本例只使用它作为清晰的配置资源基类。
#pragma once
#include "CoreMinimal.h"
#include "Engine/DataAsset.h"
#include "Engine/StaticMesh.h"
#include "WeaponConfig.generated.h"
UCLASS(BlueprintType)
class MYGAME_API UWeaponConfig : public UPrimaryDataAsset
{
GENERATED_BODY()
public:
UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Weapon")
FName WeaponId;
UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Weapon",
meta = (ClampMin = "0.0"))
float Damage = 20.0f;
UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Weapon",
meta = (ClampMin = "0.01"))
float FireInterval = 0.2f;
UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Weapon")
TSoftObjectPtr<UStaticMesh> Mesh;
};代码编译后,在编辑器中创建基于 UWeaponConfig 的资源并填写字段。预期结果是同一套 C++ 行为可以绑定多份不同资源,例如步枪和手枪各自拥有独立的 Damage、FireInterval 与 Mesh,改数值时无需修改类定义。
让 Gameplay 只消费配置
Gameplay 类可以持有一个 UWeaponConfig 引用,并在初始化或执行攻击时读取数据。关键点不是“把常量搬到另一个文件”,而是让代码只依赖配置接口,不再同时承担可编辑参数的存储职责。
UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Weapon")
TObjectPtr<UWeaponConfig> Config;
float AWeapon::GetConfiguredDamage() const
{
return Config ? Config->Damage : 0.0f;
}这是片段示例,假设它位于已有的 AWeapon 类中,并且已经包含 WeaponConfig.h。配置赋值后,调用 GetConfiguredDamage() 会返回资源中的伤害值;未配置资源时返回 0.0f,避免直接解引用空指针。

区分直接引用与软引用
标量、名称和枚举可以直接保存在 Data Asset 中;大型 Mesh、音频或其他资源若不希望因配置对象被加载而立即连带加载,可以使用 TSoftObjectPtr。软引用保存资源路径,需要在真正使用时再解析或加载,更适合控制大型内容的加载时机。
不要为了“全部数据驱动”而把任何对象都塞进同一个配置资产。角色、武器和关卡最好拥有各自的数据类型,并只暴露该职责真正需要的字段。字段过度集中会让一份资源同时被多个系统修改,最终重新形成耦合。
用资源实例验证解耦
验证时创建两份 UWeaponConfig 资源,保持代码完全不变,只让它们的 Damage 和 FireInterval 不同,再分别赋给两个武器实例。运行后若两个武器表现随各自资源变化,说明参数已经从行为代码中分离。
当新增一种武器只需要创建一份新资源、填写配置并绑定已有 Gameplay 类,而不需要复制一套武器代码时,Data Asset 才真正发挥了“数据与行为分离”的价值。