01 GAS 全景与核心架构

目标：先建立整棵知识树的"树干"——知道 GAS 由哪些核心类构成、数据如何在它们之间流动、为什么这套架构值得学习，以及如何把项目环境搭起来。

1.1 GAS 是什么

Gameplay Ability System（GAS）是 Epic Games 为其旗舰产品《虚幻争霸》（Paragon）与《堡垒之夜》（Fortnite）开发的游戏能力框架，后随引擎开源。它是一套数据驱动的能力系统，用于解决 RPG、MOBA、动作游戏中反复出现的核心机制问题：

• 角色技能的激活、消耗（Cost）、冷却（Cooldown）；
• 属性（HP、MP、攻击力等）的定义、修改、复制；
• 状态效果（Buff/Debuff）的施加、叠加、移除；
• 能力的网络同步与客户端预测；
• 逻辑与表现（VFX/SFX）的解耦。

官方定义

GameplayAbilitySystem 是一个高度灵活的框架，用于构建你在 RPG 或 MOBA 游戏中常见的能力和属性系统——主动技能、被动技能、状态效果、冷却计时器、资源消耗、技能等级，以及激活粒子或音效等。 —— Epic 官方文档

通俗理解：GAS 是一个"游戏技能工具箱"。制作"角色释放火球术"的完整流程——消耗法力、进入冷却、造成伤害、播放特效、多人同步——GAS 已把这些模块全部实现好，你只需像搭积木一样组合。

它不是一个独立插件

GAS 随引擎附带的运行时插件（Engine/Plugins/Runtime/GameplayAbilities），深度集成在引擎中，原生支持网络复制、预测回滚等高级特性。使用时只需添加模块依赖，无需单独安装。

为什么不用自己写一套

自己写能力系统，通常会撞上这堵墙：

1.2 六大核心组件（先记住这张图）

AActor（宿主：角色/物品/建筑）
 │
 └─ UAbilitySystemComponent（ASC）—— GAS 的核心枢纽
     ├─ 管理 UGameplayAbility（GA）   技能"做什么"
     ├─ 管理 UGameplayEffect（GE）    效果"怎么改属性"
     ├─ 管理 UAttributeSet（AS）      属性"有哪些数值"
     └─ 维护 FGameplayTag             状态"如何标识"
        └─ 联动 UGameplayCue（GC）    表现"怎么呈现"

各组件深入职责

UAbilitySystemComponent（ASC）

• 是什么：继承自 UActorComponent 的核心枢纽，挂在宿主 Actor 上。
• 做什么：
• 持有并管理该 Actor 的所有 Ability（ActivatableAbilities）；
• 跟踪当前生效的所有 GameplayEffect（ActiveGameplayEffects，底层是 FActiveGameplayEffectsContainer，一个 FFastArraySerializer）；
• 管理AttributeSet 与属性值；
• 维护该 Actor 的GameplayTags（GameplayTagCountContainer）；
• 负责全部网络复制与客户端预测。
• 用在哪：任何需要能力系统的 Actor 都要一个 ASC——角色、AI、武器、建筑、可交互物件都可以挂。

UGameplayAbility（GA）

• 技能的执行逻辑：定义"激活条件 → 执行逻辑（播放动画/施加效果/生成投射物）→ 结束清理"的完整生命周期。
• 每个具体技能都是一个 GA 子类：普通攻击、火球术、治疗术、闪避、被动光环……支持主动与被动、取消/中断/排队。

UGameplayEffect（GE）

• 属性修改的规则定义（数据驱动，通常用蓝图资产配置，不写逻辑）。
• 描述"以什么方式修改哪些属性、持续多久、能否叠加"。
• 所有对属性的修改都走 GE：受伤（-HP）、加速 Buff（+MoveSpeed）、持续掉血（DoT）、回蓝（+MP）……

UAttributeSet（AS）

• 属性的数据定义：用 FGameplayAttributeData + 宏声明 Actor 有哪些数值属性。
• 提供 PreAttributeChange / PostGameplayEffectExecute / PreAttributeBaseChange 等回调控制属性变更逻辑。
• 每个需要 GAS 的 Actor 至少一个 AttributeSet，可挂多个。

一句话记忆：ASC 是"枢纽/总管"，GA 是"技能怎么做"，GE 是"数值怎么变"，AS 是"有哪些数值"，Tag 是"状态怎么认"，Cue 是"怎么呈现"。

1.3 一次技能释放的数据流

以"玩家放火球"为例，数据在六个组件间流转：

玩家输入
  → ASC->TryActivateAbility(GA_Fireball)   触发
  → GA 检查 Tags / Cost / Cooldown          条件
  → GA->CommitAbility()                    扣蓝、启动冷却
  → GA->ActivateAbility()                  执行
      ├─ 创建 GE_Damage Spec（含伤害数值）
      ├─ 生成投射物（携带 Spec）
      └─ 触发 GameplayCue                   表现
  → 投射物命中目标 → 调用目标 ASC 应用 GE   修改
  → GE Modifier 修改目标 AttributeSet 属性   数值
  → PreAttributeChange / PostGameplayEffectExecute 回调
  → GameplayCue 触发命中特效                 表现
  → GA->EndAbility()                        结束

关键认知：GA 不直接改属性，GE 才是"改数值"的载体，AS 是"数值存哪"，ASC 是"谁在中间调度"。

1.4 适用场景与不适用场景

适用场景

不适用场景

判断标准：这个动作是否需要消耗、冷却、等级系统、网络同步或复杂的异步逻辑？需要就用 GA，不需要就用更轻的方案。不要在项目中期才决定引入 GAS——中途改造的成本极高。

1.5 优缺点分析（完整版）

优点

缺点

1.6 GAS 在商业游戏中的应用

Paragon（虚幻争霸）

GAS 的早期大规模使用者。5v5 MOBA，数十个英雄、每英雄 4-5 技能。验证了复杂技能交互（位移/控制/伤害/治疗）、多人同步、状态管理。

Fortnite（堡垒之夜）

GAS 经受百万级并发考验。使用特点：

• 玩家角色 Mixed 复制模式、AI 单位 Minimal（优化带宽的行业标准）；
• Adaptive Network Update Frequency 动态调整同步频率；
• 武器弹药用 plain float 而非 Attribute（避免 AttributeSet 的复制开销与限制）。

Lyra Starter Game

Epic 官方 UE5 示例，展示现代化 GAS 范式：

• AbilitySet 资产化管理技能授予；
• 与 Enhanced Input 深度集成；
• 模块化角色能力设计。

GASShooter（社区）

tranek 的第三人称射击示例：ASC 放 PlayerState、预测性射击、武器弹药管理、死亡重生。网址：github.com/tranek/GASShooter

商业实践的共性：玩家 Mixed / AI Minimal / 预测只做视觉与手感、伤害权威在服务端——这套组合贯穿本资料第 11-12 章。

1.7 项目搭建步骤（完整版）

步骤一：启用插件

1. 打开 Unreal Editor → Edit → Plugins
2. 搜索 Gameplay Abilities
3. 确保 Gameplay Abilities 插件已启用（默认已启用）
4. 重启编辑器

步骤二：编辑 Build.cs

using UnrealBuildTool;

public class YourProject : ModuleRules
{
    public YourProject(ReadOnlyTargetRules Target) : base(Target)
    {
        PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;

        PublicDependencyModuleNames.AddRange(new string[]
        {
            "Core", "CoreUObject", "Engine", "InputCore",
            "EnhancedInput",        // UE5 输入系统
            "GameplayAbilities",    // GAS 核心模块
            "GameplayTags",         // 标签系统
            "GameplayTasks"         // AbilityTask 依赖
        });
    }
}

常见陷阱：忘记添加 GameplayTasks 会导致 AbilityTask 相关编译错误。三个 GAS 模块缺一不可。

步骤三：调用 InitGlobalData()

• UE 4.24 ~ 5.2：使用 TargetData 前必须调用 UAbilitySystemGlobals::Get().InitGlobalData()，否则使用 TargetData 会崩溃。
• UE 5.3+：引擎自动调用，无需手动（保留调用也无害）。

// YourAssetManager.h
UCLASS()
class YOURPROJECT_API UYourAssetManager : public UAssetManager
{
    GENERATED_BODY()
public:
    virtual void StartInitialLoading() override;
};

// YourAssetManager.cpp
#include "YourAssetManager.h"
#include "AbilitySystemGlobals.h"

void UYourAssetManager::StartInitialLoading()
{
    Super::StartInitialLoading();
    UAbilitySystemGlobals::Get().InitGlobalData();   // UE 4.24-5.2 必须
}

[/Script/Engine.Engine]
AssetManagerClassName=/Script/YourProject.YourAssetManager

步骤四：验证搭建

// 在任意 Character 构造函数中
AMyCharacter::AMyCharacter()
{
    AbilitySystemComponent = CreateDefaultSubobject<UAbilitySystemComponent>(TEXT("AbilitySystemComponent"));
    AbilitySystemComponent->SetIsReplicated(true);   // 多人需要
}

编译通过即环境就绪。后续的初始化、复制模式、授予技能在第 03/13 章展开。

1.8 GAS 的历史（准确版）

注意：GAS 在 UE5 中仍然是插件（Engine/Plugins/Runtime/GameplayAbilities），只是随引擎发行、无需手动启用。所谓"移入引擎核心、不再需要 Plugin"的说法不准确。

1.9 本章验证

• [ ] 新建/打开一个 C++ 项目，在 .Build.cs 中加入 GAS 三个模块依赖，编译通过；
• [ ] 能画出 ASC / GA / GE / AS / Tag / Cue 六者之间的关系图；
• [ ] 能口述"放火球"的数据流：输入 → 激活 → 消耗 → 执行 → 改数值 → 表现 → 结束；
• [ ] 能判断"哪些项目适合/不适合 GAS"并说明理由。

1.10 练习题

1. 用自己的话解释 GAS 六大组件各自的职责和关系。
2. 判断以下哪些项目适合 GAS： - A. 2D 平台跳跃，只有跳跃和攻击两个动作 - B. 多人在线 RPG，20 种技能 + 50 种 Buff - C. 文字冒险游戏 - D. 5v5 MOBA
3. 按本章步骤搭建 GAS 项目环境，在 Character 中创建 ASC 并成功编译。
4. 如果要做一个 MOBA，ASC 放 PlayerState 还是 Character？为什么？（答案参考第 03 章）

下一章：02 GameplayTags 标签系统