Game Ability System

自动关联目录:Game Ability System

GAS 解决的是"技能"这类需求的通用难题:冷却与消耗、属性修改、持续效果、标签状态、预测与回滚、以及这一切的网络同步。

它是引擎里少有的"框架级"系统——不是给几个函数,而是规定了一整套数据流向。上手成本高,但一旦按它的范式写,技能之间天然不会互相打架。

本目录

笔记内容状态
FGameplayTag标签:整个系统的"词汇表"已补充
UAbilitySystemComponent系统的挂载点与入口(ASC)、复制模式已补充
UAttributeSet属性集:血量、攻击力等已补充
UGameplayAbility技能本体:激活、提交、结束、网络策略已补充
UGameplayEffect属性修改与持续效果、堆叠、Execution已补充
UAbilityTask技能里的异步步骤已补充
AGameplayCueNotify_Actor表现层:特效、音效已补充

阅读顺序与优先级

顺序笔记为什么
1FGameplayTag它决定了后面好不好扩展,标签设计错了全系统跟着改
2UAbilitySystemComponent挂载点与复制模式,是最早也最难改的决定
3UAttributeSet数据层
4UGameplayEffect唯一正当的属性修改途径
5UGameplayAbility行为层
6UAbilityTask异步步骤
7AGameplayCueNotify_Actor表现层

只有半小时:Tag + ASC。前者决定扩展性,后者决定复制边界。

排查入口

现象先查
技能激活不了UGameplayAbility:Tag 阻断 / 冷却 / 是否 EndAbility
重生后技能失效UAbilitySystemComponent:InitAbilityActorInfo 两端是否都调了
数值不对 / 到期回退UGameplayEffect:Duration Policy 与聚合顺序
属性显示与实际不符UAttributeSet:Base/Current 与 RepNotify
技能卡住不结束UAbilityTask:ReadyForActivation 与四个回调
特效不触发 / 残留AGameplayCueNotify_Actor:Tag 与扫描路径
手感与回滚问题网络预测与回滚

第一调试命令:showdebug abilitysystem——能一次看到 Attribute、Tag、活跃 Ability、GE 列表。

一次技能释放的数据流

玩家输入
  → ASC::TryActivateAbility(按标签/类/输入 ID)
  → 检查:冷却(Cooldown GE)、消耗(Cost GE)、标签阻断(Blocked Tags)
  → UGameplayAbility::ActivateAbility
       ├── CommitAbility(真正扣冷却与消耗)
       ├── 播放蒙太奇 / 等待事件(UAbilityTask)
       ├── ApplyGameplayEffectToTarget(造成伤害/加 Buff)
       └── EndAbility
  → GameplayCue(表现:特效、音效)
  → 属性变化通过 AttributeSet 复制同步

关键分工:数据(属性、效果)走 GE 与 AttributeSet,表现走 GameplayCue。表现不参与逻辑判定,所以延迟或丢包都不会影响结果。

三个必须分清的概念

概念是什么会不会自动复制
GameplayAbility一段可执行的行为(技能/被动)激活状态复制
GameplayEffect对属性的修改描述(数据)应用于目标后由 ASC 管理
GameplayCue表现(特效/音效/相机)通过标签触发,走网络事件

最常见的误用是在 Ability 里直接改属性。正确做法是 Apply 一个 GE——这样才能享受预测、堆叠、持续时间、标签阻断等一整套机制。

网络与预测

机制说明
本地预测客户端先执行,等服务端确认;不一致则回滚重放
LocalPredicted最常用的网络执行策略
Server Only / Server Initiated不做预测
回滚靠保存的快照恢复属性与标签

预测的前提是同一段代码在两端跑出相同结果,所以:不要在 Ability 逻辑里读本地随机、本地时间或只存在于一端的数据。

上手建议

  1. 先理解 FGameplayTag——它是 GAS 的词汇表,标签设计决定了后面好不好扩展
  2. 再理解 AttributeSet 与 GE 的修改方式(Additive / Multiplicative / Override)
  3. 最后才是 Ability 与 Task 的编写
常见需求用什么实现
造成伤害GE(Instant,修改 Health)
持续回血/BuffGE(Infinite / Has Duration + Periodic)
冷却GE 带 Cooldown 标签,或用 Cooldown GE
消耗(蓝量)GE(Instant,Cost)
眩晕/沉默GE 授予 State.Stun 标签,Ability 用 Blocked Tags 拦
被动技能Ability 设为 Passive / 用 Infinite GE 触发
蓄力/引导UAbilityTask 等待输入或时间

参考