Game Ability System
自动关联目录:Game Ability System
GAS 解决的是"技能"这类需求的通用难题:冷却与消耗、属性修改、持续效果、标签状态、预测与回滚、以及这一切的网络同步。
它是引擎里少有的"框架级"系统——不是给几个函数,而是规定了一整套数据流向。上手成本高,但一旦按它的范式写,技能之间天然不会互相打架。
本目录
| 笔记 | 内容 | 状态 |
|---|---|---|
| FGameplayTag | 标签:整个系统的"词汇表" | 已补充 |
| UAbilitySystemComponent | 系统的挂载点与入口(ASC)、复制模式 | 已补充 |
| UAttributeSet | 属性集:血量、攻击力等 | 已补充 |
| UGameplayAbility | 技能本体:激活、提交、结束、网络策略 | 已补充 |
| UGameplayEffect | 属性修改与持续效果、堆叠、Execution | 已补充 |
| UAbilityTask | 技能里的异步步骤 | 已补充 |
| AGameplayCueNotify_Actor | 表现层:特效、音效 | 已补充 |
阅读顺序与优先级
| 顺序 | 笔记 | 为什么 |
|---|---|---|
| 1 | FGameplayTag | 它决定了后面好不好扩展,标签设计错了全系统跟着改 |
| 2 | UAbilitySystemComponent | 挂载点与复制模式,是最早也最难改的决定 |
| 3 | UAttributeSet | 数据层 |
| 4 | UGameplayEffect | 唯一正当的属性修改途径 |
| 5 | UGameplayAbility | 行为层 |
| 6 | UAbilityTask | 异步步骤 |
| 7 | AGameplayCueNotify_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 逻辑里读本地随机、本地时间或只存在于一端的数据。
上手建议
- 先理解 FGameplayTag——它是 GAS 的词汇表,标签设计决定了后面好不好扩展
- 再理解 AttributeSet 与 GE 的修改方式(Additive / Multiplicative / Override)
- 最后才是 Ability 与 Task 的编写
| 常见需求 | 用什么实现 |
|---|---|
| 造成伤害 | GE(Instant,修改 Health) |
| 持续回血/Buff | GE(Infinite / Has Duration + Periodic) |
| 冷却 | GE 带 Cooldown 标签,或用 Cooldown GE |
| 消耗(蓝量) | GE(Instant,Cost) |
| 眩晕/沉默 | GE 授予 State.Stun 标签,Ability 用 Blocked Tags 拦 |
| 被动技能 | Ability 设为 Passive / 用 Infinite GE 触发 |
| 蓄力/引导 | UAbilityTask 等待输入或时间 |
参考
- UE5 GameplayAbilitySystem 文档
- 引擎源码:
GameplayAbilities模块
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/a131da00.html
更新于:2026年11月16日