UAttributeSet
自动关联目录:UAttributeSet
属性集定义、管理、复制一个或多个属性值。属性是"在游戏机制中具有特定含义的数值":可以代表游戏资源(Health)、影响其他规则的参考值(Base Attack Power),也可以代表无状态量(Applied Damage)。
一句话定位:AttributeSet 是 GAS 的数据层,GE 是修改它的唯一正当途径,Tag 是描述它的元数据。
基本写法
UCLASS()
class UMyAttributeSet : public UAttributeSet
{
GENERATED_BODY()
public:
UPROPERTY(BlueprintReadOnly, Category = "Vital", ReplicatedUsing = OnRep_Health)
FGameplayAttributeData Health;
ATTRIBUTE_ACCESSORS(UMyAttributeSet, Health) // 生成 GAMEPLAYATTRIBUTE_VALUE_GETTER 等
UPROPERTY(BlueprintReadOnly, Category = "Vital", ReplicatedUsing = OnRep_MaxHealth)
FGameplayAttributeData MaxHealth;
ATTRIBUTE_ACCESSORS(UMyAttributeSet, MaxHealth)
virtual void PreAttributeChange(const FGameplayAttribute& Attribute, float& NewValue) override;
virtual void PostGameplayEffectExecute(const FGameplayEffectModCallbackData& Data) override;
virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutProps) const override;
};ATTRIBUTE_ACCESSORS 宏会生成 GetHealthAttribute()、GetHealth()、SetHealth() 一整套样板,不要手写成裸 float 成员——那样就脱离了 GAS 的修改链路。
BaseValue 与 CurrentValue
这是 AttributeSet 里最关键、也最容易被忽略的区分:
| 字段 | 含义 |
|---|---|
BaseValue | 永久值,由 Instant/Periodic GE 或 Setter 直接改 |
CurrentValue | 当前值,等于 BaseValue 加上所有 Duration/Infinite 修正(Buff) |
Health: BaseValue = 100,被 +50 的持续 Buff 影响
→ CurrentValue = 150,BaseValue 仍是 100
→ Buff 到期后 CurrentValue 回到 100绝大多数显示与判定都应该读 CurrentValue(即 GetHealth());只有"存档、升级、永久改变"才动 BaseValue。用错会表现为"Buff 消失了但效果还在"或"重连后 Buff 没了"。
关键回调
| 回调 | 时机 | 该做什么 |
|---|---|---|
PreAttributeChange | 任何值即将改变时 | 钳制范围(Clamp),如 Health ∈ [0, MaxHealth] |
PostAttributeChange | 值已改变后 | 触发依赖该属性的逻辑(较少用) |
PostGameplayEffectExecute | 一个 Instant/Periodic GE 执行完后 | 伤害结算、死亡判定、触发事件 |
PreGameplayEffectExecute | GE 执行前 | 修改 GE 的修正量(如伤害减免) |
void UMyAttributeSet::PreAttributeChange(const FGameplayAttribute& Attribute, float& NewValue)
{
Super::PreAttributeChange(Attribute, NewValue);
if (Attribute == GetHealthAttribute())
NewValue = FMath::Clamp(NewValue, 0.f, GetMaxHealth()); // 在这里钳制,而不是到处判断
}
void UMyAttributeSet::PostGameplayEffectExecute(const FGameplayEffectModCallbackData& Data)
{
Super::PostGameplayEffectExecute(Data);
if (Data.EvaluatedData.Attribute == GetHealthAttribute())
{
SetHealth(FMath::Clamp(GetHealth(), 0.f, GetMaxHealth()));
if (GetHealth() <= 0.f) { /* 交由 Ability/ASC 处理死亡 */ }
}
}用 Meta Attribute 做伤害管线
Applied Damage 这类"无状态量"是 GAS 的经典套路——Meta Attribute:只在结算过程中存在,用完即弃。
1. GE_Damage (Instant) 修改 Damage 属性(Meta)
2. PostGameplayEffectExecute 里读到 Damage
3. 扣掉护甲、算上加成 → 得到最终伤害
4. 用另一个 Instant GE 扣 Health
5. Damage 属性重置为 0好处是伤害的减免/加成/反射全都是 GE 的一环,可以被 Modifier、Tag、堆叠规则统一处理,不需要在代码里写公式。
网络复制
| 要点 | 说明 |
|---|---|
GetLifetimeReplicatedProps | 必须注册,否则客户端收不到 |
OnRep_XXX | 必须调 GAMEPLAYATTRIBUTE_REPNOTIFY(宏),否则客户端不会跑回调链 |
REPNOTIFY_Always | 值没变也要触发(用于依赖 PreAttributeChange 的钳制) |
| 只在服务端改 | 客户端修改会被服务端覆盖,产生抖动 |
void UMyAttributeSet::OnRep_Health(const FGameplayAttributeData& OldHealth)
{
GAMEPLAYATTRIBUTE_REPNOTIFY(UMyAttributeSet, Health, OldHealth);
}漏掉 GAMEPLAYATTRIBUTE_REPNOTIFY 是最常见的"客户端属性不更新"原因。
与 ASC 的关系
| 事项 | 说明 |
|---|---|
| 挂载 | AttributeSet 由 UAbilitySystemComponent 拥有,通常作为 Actor 的子对象创建 |
| 可以有多个 | 按职责拆分(Vital / Combat / Resource)便于复用 |
| 全局查找 | ASC->GetSet<UMyAttributeSet>() |
| 初始化 | 用 GE(推荐,走完整链路)或 InitHealth() 系列直接设初值 |
设计建议
| 建议 | 说明 |
|---|---|
| 按职责拆多个 Set | 一个巨大的 AttributeSet 会成为合并冲突中心 |
| 属性只放"数值" | 类别/状态用 FGameplayTag |
| 所有修改都走 GE | 直接 SetHealth 会绕过 Modifier、Tag 与归因 |
钳制集中在 PreAttributeChange | 散落在业务里必然漏 |
| 区分资源型与统计型 | 血量要复制,伤害统计可能只需服务端 |
常见坑
| 坑 | 说明 |
|---|---|
把属性写成裸 float | 脱离 GE 链路,Buff 与复制全失效 |
| 混淆 Base/Current | Buff 表现异常,存档数据错乱 |
忘记 ATTRIBUTE_ACCESSORS | 在 GE 里选不到这个属性 |
漏写 GAMEPLAYATTRIBUTE_REPNOTIFY | 客户端数值不刷新 |
在 PostGameplayEffectExecute 里又改同一个属性 | 可能递归,要小心触发链 |
| 用属性表达状态 | 比如 IsStunned 做成 0/1,应该用 Tag |
| Meta 属性忘记清零 | 下一次伤害计算会叠加脏值 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/76cb5781.html
更新于:2026年11月16日