UE5 Gameplay Ability System (GAS) 完全指南

前言#

Gameplay Ability System（GAS）是Epic官方推出的强大技能系统框架，被《堡垒之夜》等顶级游戏采用。它提供了一套完整的技能、buff、冷却管理的解决方案。

本文带你从零理解GAS的设计思想，并手把手实现一个简单的技能系统。

什么是GAS？#

GAS是Unreal Engine的核心技能/属性系统框架，核心特点是：

特性	说明
ASC架构	Ability System Component驱动
属性委托	GameplayAttribute系统
技能标签	Tag驱动的权限控制
预测系统	客户端预测支持
技能委托	完整的生命周期事件

简单来说：GAS让你能优雅地实现技能、buff、属性、冷却一套完整的战斗系统。

GAS核心概念#

1. ASC（Ability System Component）#

挂在Actor上的核心组件，负责管理所有技能：

1
UPROPERTY()
2
UAbilitySystemComponent* AbilitySystemComponent;

2. AttributeSet（属性集）#

存储角色的数值属性（生命值、魔法值、攻击力等）：

1
UCLASS()
2
class UMyAttributeSet : public UAttributeSet
3
{
4
    GENERATED_BODY()
5

6
public:
7
    UPROPERTY()
8
    float Health = 100.f;
9

10
    UPROPERTY()
11
    float MaxHealth = 100.f;
12

13
    UPROPERTY()
14
    float Mana = 50.f;
15

16
    UPROPERTY()
17
    float MaxMana = 50.f;
18

19
    UPROPERTY()
20
    float AttackPower = 10.f;
21
};

3. GameplayAbility（技能）#

具体的技能逻辑：

1
UCLASS()
2
class UMyGameplayAbility : public UGameplayAbility
3
{
4
    GENERATED_BODY()
5

6
public:
7
    // 技能激活时调用
8
    virtual void ActivateAbility(const FGameplayAbilitySpecHandle Handle,
9
                                FGameplayAbilityActorInfo* ActorInfo,
10
                                const FGameplayAbilityActivationInfo& ActivationInfo,
11
                                FOnGameplayAbilityEnded::FDelegate* OnEnded) override;
12

13
    // 技能结束时调用
14
    virtual void EndAbility(const FGameplayAbilitySpecHandle Handle,
15
                           FGameplayAbilityActorInfo* ActorInfo,
16
                           FGameplayAbilityActivationInfo ActivationInfo,
17
                           bool bReplicateEndAbility,
18
                           bool bWasCancelled) override;
19
};

4. GameplayEffect（效果）#

用于修改属性（buff/debuff）：

1
// 瞬间生效的效果（回血、掉血）
2
TSubclassOf<UGameplayEffect> InstantEffect;
3

4
// 持续效果（持续回血、dot）
5
TSubclassOf<UGameplayEffect> DurationEffect;
6

7
// 无限持续效果（buff）
8
TSubclassOf<UGameplayEffect> InfiniteEffect;

5. GameplayTags（标签）#

用于权限控制和技能识别：

1
// 在ProjectSettings中定义Tag
2
// Ability.Book.Ice
3
// Buff.Shield
4
// Debuff.Slow

项目配置#

启用GAS插件#

在 Edit > Plugins 中启用：

GameplayAbilities — 核心GAS插件

创建AttributeSet#

1
#pragma once
2
#include "CoreMinimal.h"
3
#include "AttributeSet.h"
4
#include "MyAttributeSet.generated.h"
5

6
UCLASS()
7
class UMyAttributeSet : public UAttributeSet
8
{
9
    GENERATED_BODY()
10

11
public:
12
    // 生命值
13
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attributes")
14
    FGameplayAttributeData Health;
15

16
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attributes")
17
    FGameplayAttributeData MaxHealth;
18

19
    // 魔法值
20
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attributes")
21
    FGameplayAttributeData Mana;
22

23
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attributes")
24
    FGameplayAttributeData MaxMana;
25

26
    // 攻击力
27
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attributes")
28
    FGameplayAttributeData AttackPower;
29

30
    // 回调：当属性被修改时触发
31
    virtual void PostGameplayEffectExecute(const FGameplayEffectModCallbackData& Data) override;
32
};

1
#include "MyAttributeSet.h"
2
#include "GameplayEffect.h"
3
#include "GameplayEffectExtension.h"
4

5
void UMyAttributeSet::PostGameplayEffectExecute(const FGameplayEffectModCallbackData& Data)
6
{
7
    if (Data.EvaluatedData.Attribute == GetHealthAttribute())
8
    {
9
        SetHealth(FMath::Clamp(GetHealth(), 0.f, GetMaxHealth()));
10
    }
11
    else if (Data.EvaluatedData.Attribute == GetManaAttribute())
12
    {
13
        SetMana(FMath::Clamp(GetMana(), 0.f, GetMaxMana()));
14
    }
15
}

绑定ASC到Character#

1
UCLASS()
2
class AMyCharacter : public ACharacter
3
{
4
    GENERATED_BODY()
5

6
public:
7
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Abilities")
8
    TObjectPtr<UAbilitySystemComponent> AbilitySystemComponent;
9

10
    UPROPERTY()
11
    TObjectPtr<UMyAttributeSet> AttributeSet;
12

13
    virtual void PossessedBy(AController* NewController) override;
14
    virtual void OnRep_PlayerState() override;
15
};

1
#include "MyCharacter.h"
2
#include "MyAttributeSet.h"
3

4
void AMyCharacter::PossessedBy(AController* NewController)
5
{
6
    Super::PossessedBy(NewController);
7

8
    if (AbilitySystemComponent)
9
    {
10
        AbilitySystemComponent->InitAbilityActorInfo(this, this);
11

12
        // 给ASC注册AttributeSet
13
        AbilitySystemComponent->AddAttributeSetSubobject(AttributeSet);
14

15
        // 赋予初始技能
16
        GiveDefaultAbilities();
17
    }
18
}
19

20
void AMyCharacter::OnRep_PlayerState()
21
{
22
    Super::OnRep_PlayerState();
23

24
    if (AbilitySystemComponent)
25
    {
26
        AbilitySystemComponent->InitAbilityActorInfo(this, this);
27
    }
28
}
29

30
void AMyCharacter::GiveDefaultAbilities()
31
{
32
    // 在这里赋予角色的默认技能
33
    // 使用GrantAbility或通过DataAsset配置
34
}

实战：创建Fireball技能#

步骤1：创建技能蓝图#

创建GameplayAbility子类蓝图 BP_FireballAbility
在蓝图编辑器中设置：
- Ability Tags：添加 Damage.Fire
- Cooldown：设置冷却时间
- Cost：设置消耗（魔法值）

步骤2：实现技能逻辑#

1
UCLASS()
2
class UFireballAbility : public UGameplayAbility
3
{
4
    GENERATED_BODY()
5

6
public:
7
    // 发射火球
8
    virtual void ActivateAbility(const FGameplayAbilitySpecHandle Handle,
9
                                FGameplayAbilityActorInfo* ActorInfo,
10
                                const FGameplayAbilityActivationInfo& ActivationInfo,
11
                                FOnGameplayAbilityEnded::FDelegate* OnEnded) override;
12

13
    // 激活技能的输入事件
14
    UFUNCTION(BlueprintCallable, Category = "Ability")
15
    void InputPressed(const FGameplayAbilitySpecHandle Handle,
16
                     const FGameplayAbilityActorInfo* ActorInfo,
17
                     const FGameplayAbilityActivationInfo& ActivationInfo);
18
};

1
#include "FireballAbility.h"
2
#include "Abilities/GameplayAbilityTargetActor_SingleLineTrace.h"
3
#include "Abilities/GameplayAbilityTypes.h"
4

5
void UFireballAbility::ActivateAbility(const FGameplayAbilitySpecHandle Handle,
6
                                       FGameplayAbilityActorInfo* ActorInfo,
7
                                       const FGameplayAbilityActivationInfo& ActivationInfo,
8
                                       FOnGameplayAbilityEnded::FDelegate* OnEnded)
9
{
10
    // 检查技能是否有效
11
    if (!CommitAbility(Handle, ActorInfo, ActivationInfo))
12
    {
13
        EndAbility(Handle, ActorInfo, ActivationInfo, true, false);
14
        return;
15
    }
16

17
    // 获取技能所有者
18
    AActor* Owner = ActorInfo->OwnerActor.Get();
19

20
    // 生成火球逻辑...
21
    // 这里可以Spawn一个Actor或播放特效
22

23
    UE_LOG(LogTemp, Warning, TEXT("Fireball Activated!"));
24

25
    // 结束技能
26
    EndAbility(Handle, ActorInfo, ActivationInfo, false, false);
27
}
28

29
void UFireballAbility::InputPressed(const FGameplayAbilitySpecHandle Handle,
30
                                    const FGameplayAbilityActorInfo* ActorInfo,
31
                                    const FGameplayAbilityActivationInfo& ActivationInfo)
32
{
33
    TryActivateAbility(Handle);
34
}

步骤3：赋予技能#

1
// 在Character的GiveDefaultAbilities中
2
void AMyCharacter::GiveDefaultAbilities()
3
{
4
    if (!AbilitySystemComponent) return;
5

6
    // 创建技能Spec
7
    FGameplayAbilitySpec Spec;
8
    Spec.Ability = NewObject<UFireballAbility>();
9
    Spec.Level = 1;
10

11
    // 赋予技能
12
    AbilitySystemComponent->GiveAbility(Spec);
13
}

冷却系统#

设置Cooldown GameplayEffect#

1
// 定义冷却GE
2
TSubclassOf<UGameplayEffect> CooldownGE = StaticLoadClass(
3
    UGameplayEffect::StaticClass(),
4
    nullptr,
5
    TEXT("GameplayEffect'/Game/Effects/GE_Cooldown.GE_Cooldown_C'")
6
);
7

8
// 检查是否在冷却中
9
bool AMyCharacter::IsAbilityOnCooldown(FGameplayTag AbilityTag)
10
{
11
    FGameplayTagContainer OwnedTags;
12
    AbilitySystemComponent->GetOwnedGameplayTags(OwnedTags);
13
    return OwnedTags.HasTag(AbilityTag);
14
}

常见问题#

Q: GAS和普通函数调用的区别？#

A: GAS提供了完整的生命周期管理、预测系统、网络同步、冷却/消耗验证。普通函数调用没有这些。

Q: AttributeSet为什么要用FGameplayAttributeData而不是float？#

A: FGameplayAttributeData支持元属性（MaxHealth）和Clamp设置，能正确处理属性比例修改。

Q: 如何调试GAS？#

A: 使用ASC->Debug命令可以在屏幕上显示所有技能和属性的详细信息。

总结#

GAS是UE5最强大的技能系统框架，核心组成：

ASC — 技能系统核心组件
AttributeSet — 管理角色属性
GameplayAbility — 定义技能逻辑
GameplayEffect — 实现buff/debuff
GameplayTags — 权限控制和识别

建议从官方示例项目入手，熟悉后再自定义实现复杂系统。