GameplayEffect (GE)#

和 GameplayAbility 的区别#

• GameplayAbility：决定什么时候触发、由谁触发、触发时做什么
• GameplayEffect：决定生效后具体改什么、持续多久、如何叠加

一个常见组合是：

1. GameplayAbility 被输入或事件激活
2. 能力内部创建 GameplayEffectSpec
3. 通过 ASC 把效果应用到自己或目标

运行时形态#

编辑器里配置的是 UGameplayEffect 类定义，真正运行时参与计算的是 GameplayEffectSpec。

Spec 会把下面这些信息组合到一起：

• GE 类本身的静态配置
• 等级
• EffectContext
• 动态设置的 SetByCaller 数值
• 捕获到的属性和标签

GameplayEffect 常见关注点#

继续阅读#

• GameplayEffectSpec
• ApplyGamePlayEffectToSelf
• MMC
• Execution Calculation
  • 添加/移除标签 (AddGameplayTag, RemoveGameplayTag)。
  • 【技巧】监听标签变化 (RegisterGameplayTagEvent)：当特定标签被添加或移除时触发回调。这对于状态机或触发器非常有用。
  • 检查标签存在性 (HasMatchingGameplayTag, HasAllMatchingGameplayTags, HasAnyMatchingGameplayTags)。

5. 能力任务 (Ability Tasks)

   • 【注意】ASC 负责管理由 GameplayAbility 创建的 AbilityTask 实例的生命周期。

6. 网络同步 (Replication)

   • 【重点】ASC 内置了对属性、标签和效果激活的网络复制支持。需要正确设置 Actor 和 Component 的复制策略。
   • 支持 预测 (Prediction)，以减少网络延迟带来的影响。

如何获取 ASC#

通常有几种方式获取目标 Actor 的 ASC：

1. 直接附加: 如果 ASC 直接附加在 Actor 上（如 Character），可以直接获取：

   1
   UAbilitySystemComponent* ASC = GetAbilitySystemComponent(); // AActor 类的方法
   2
   // or
   3
   UAbilitySystemComponent* ASC = FindComponentByClass<UAbilitySystemComponent>();
   

2. 通过接口: 实现 IAbilitySystemInterface 接口，通常在 Character 或 PlayerState 中实现 GetAbilitySystemComponent() 方法。这是推荐的方式，因为它提供了统一的访问点。

   1
   // 在实现了接口的类内部
   2
   virtual UAbilitySystemComponent* GetAbilitySystemComponent() const override { return AbilitySystemComponent; }
   3
   
   4
   // 从其他地方获取
   5
   IAbilitySystemInterface* ASI = Cast<IAbilitySystemInterface>(TargetActor);
   6
   if (ASI)
   7
   {
   8
       UAbilitySystemComponent* ASC = ASI->GetAbilitySystemComponent();
   9
   }
   

3. 通过 PlayerState: 在多人游戏中，ASC 常常放在 PlayerState 上，因为它在客户端和服务端都存在且与玩家生命周期绑定。

   1
   APlayerState* PS = GetPlayerState();
   2
   if (PS)
   3
   {
   4
       IAbilitySystemInterface* ASI = Cast<IAbilitySystemInterface>(PS);
   5
       if (ASI)
   6
       {
   7
           UAbilitySystemComponent* ASC = ASI->GetAbilitySystemComponent();
   8
       }
   9
   }
   

重要概念链接#

• AttributeSet：属性集的具体实现。
• GameplayAbility：定义能力的蓝图或 C++ 类。
• GameplayEffect：定义属性修改或状态效果的蓝图或 C++ 类。
• Gameplay Tags：用于状态管理和逻辑判断的标签系统。
• 预测：处理网络延迟的技术。
• AbilityTask：能力中执行异步操作的节点。
• MetaAttributes

常见问题与注意点#

• 【注意】确保 ASC 和相关的 AttributeSet 被正确初始化和注册。
• 【注意】在多人游戏中，理解 ASC 的所有权（通常是服务器）和复制策略至关重要。客户端不能直接修改服务器上的属性或随意激活能力（除非使用预测）。
• 【技巧】利用 GameplayEffectContext 传递额外信息（如伤害来源、暴击标记）。见 EffectContext。