虚幻GAS底层原理解剖四 (TAG)

文章目录


前言

深入 GAS(Gameplay Ability System)中的 Tag System 实现原理,这是 GAS 中一个非常精巧且强大的模块,支撑了:

  1. 技能激活条件
  2. 效果(GE)应用与否
  3. 角色状态判断(如"眩晕"、"隐身")
  4. 整个系统的"规则引擎"和"语义判定"

一、Tag System 是什么?

:
表达角色、技能、效果、属性等的语义状态和行为约束。

类似状态机中的"状态标识"或者 ECS 中的"标签组件"。

例如:

text 复制代码
Tag:   Status.Stunned       ← 表示眩晕
Tag:   Ability.BlockJump    ← 表示禁止跳跃
Tag:   Skill.Fireball       ← 表示火球技能
Tag:   Relationship.Enemy   ← 表示敌人单位

它们可以被:

  1. GE 授予/移除
  2. GA 监听/过滤
  3. AttributeSet 逻辑判断
  4. 网络同步/自动触发回调

二、核心结构组成

类名 作用
FGameplayTag 单个标签结构,底层是 FName
FGameplayTagContainer 标签容器,可包含多个标签
UGameplayTagsManager 全局管理器,构建标签层级和注册表
GameplayTag.ini 标签配置文件,集中定义标签结构

三、标签的底层原理

  1. FGameplayTag
    这是标签的最小单元,本质是个 FName,但支持层级结构:
cpp 复制代码
FGameplayTag StunTag = FGameplayTag::RequestGameplayTag("Status.Stunned");

层级结构以 . 分隔,例如:

nginx 复制代码
Status
├── Status.Stunned
├── Status.Rooted
Ability
├── Ability.Magic
│   └── Ability.Magic.Fireball

支持"包含关系"判断:

cpp 复制代码
StunTag.MatchesTag("Status")  → true
  1. FGameplayTagContainer
    容器类,表示"拥有的一组标签":
cpp 复制代码
FGameplayTagContainer Tags;
Tags.AddTag(FGameplayTag::RequestGameplayTag("Status.Stunned"));

:
判断是否包含某个标签或子标签

复制代码
添加/移除标签   

与其他容器做交集、并集等运算

四、标签系统的运行机制

GAS 中使用 Tag 的方式主要分为以下几类:

  1. 技能(GA)激活条件控制
cpp 复制代码
AbilityTags: Ability.Fireball

ActivationBlockedTags: Status.Stunned
ActivationRequiredTags: State.CombatReady

激活前 GAS 会做自动检查:

cpp 复制代码
if (OwnerHasTag(Status.Stunned)) {
    BlockActivation();
}
  1. 效果(GE)的条件过滤
cpp 复制代码
GrantedTags: Status.Stunned         // 被应用时添加这个标签
OngoingTagRequirements:
    Required: Target.IsAlive
    Blocked: Target.HasShield
  1. 技能触发、监听和响应
    使用 WaitGameplayEvent 监听具有某标签的 GameplayEvent:
cpp 复制代码
WaitGameplayEvent(EventTag = "Event.OnHit")
  1. 网络同步与事件广播
    GAS 会自动在网络上传输 TagContainer 变化,比如一个 GE 添加了 Status.Stunned,所有客户端都知道它被"眩晕"了。

五、Tag 系统与其他模块协同逻辑

模块 使用方式
Ability(GA) 控制是否能激活、是否中断
Effect(GE) 控制能否应用、应用时授予标签
AttributeSet 用来判定当前状态,比如不能回血
ASC 保持一个 OwnedTags,动态更新角色状态

示例:火球技能不能在"沉默"状态下释放

ini 复制代码
AbilityTags = Ability.Magic.Fireball
ActivationBlockedTags = Status.Silenced

当角色被施加了 GE:Status.Silenced,该 GA 自动不能激活。

六、如何维护和组织标签:GameplayTags.ini

推荐统一维护所有标签,在 DefaultGameplayTags.ini 文件中注册:

ini 复制代码
[GameplayTags]
+GameplayTags=Ability.Magic.Fireball
+GameplayTags=Status.Stunned
+GameplayTags=Status.Silenced
+GameplayTags=Target.Friendly
+GameplayTags=Target.Enemy

优点:

  1. 自动提示 / 蓝图可选
  2. 防止拼写错误
  3. 支持导出层级树(调试友好)

七、底层调用逻辑示意(源码)

cpp 复制代码
bool FGameplayTagContainer::HasTag(FGameplayTag TagToCheck, bool bExactMatch) const
{
    for (const FGameplayTag& Tag : GameplayTags)
    {
        if (Tag.MatchesTag(TagToCheck)) return true;
    }
    return false;
}
cpp 复制代码
bool FGameplayTag::MatchesTag(const FGameplayTag& OtherTag) const
{
    return OtherTag == ThisTag || OtherTag.IsParentOf(ThisTag);
}

GAS 利用层级结构快速做匹配判断。

八、调试和可视化技巧

  1. Gameplay Debugger GDT(按 ~ 打开)

    显示当前角色所有 Active Tags

  2. ASC 的 GetOwnedGameplayTags()

    随时可打印当前标签状态

  3. 蓝图中可用 "Has Matching Gameplay Tag"、"Add Gameplay Tag" 节点操作

九、使用规范建议

场景 推荐做法
表示状态 Status.xxx(如 Status.Stunned)
分类技能 Ability.Class.Type(如 Ability.Magic.Fireball)
表示阻断 Block.Action(如 Block.Jump)
表示目标类型 Target.Enemy / Target.Self
表示 BUFF、DEBUFF Effect.Buff.SpeedUp / Effect.Debuff.Slow

总结:Tag 是 GAS 的"布尔变量 + 规则引擎"

:
通过标签系统进行统一的语义控制、判定与过滤。

模块 使用 Tag 的方式
GA 激活限制、冷却中断、触发事件
GE 应用判断、附加状态标签
ASC 状态维护、网络同步
UI/逻辑 状态显示、行为约束
相关推荐
Kingsdesigner3 小时前
游戏开发流程革命:我用Substance插件,在UE5内实现材质的实时“创世纪”
游戏·adobe·ue5·游戏引擎·游戏开发·设计师·substance 3d
污领巾3 小时前
虚幻GAS底层原理解剖七 (ASC)
游戏引擎·php·虚幻
污领巾16 小时前
虚幻GAS底层原理解剖二 (GE)
游戏引擎·虚幻
南無忘码至尊1 天前
Unity编辑器工具:一键为场景中所有MeshRenderer对象添加指定脚本
unity·c#·游戏引擎·游戏开发
枯萎穿心攻击1 天前
算法入门第一篇:算法核心:复杂度分析与数组基础
算法·unity·矩阵·c#·游戏引擎
王维志1 天前
Unity轻量观察相机
unity·游戏引擎
DoomGT2 天前
Physics Simulation - UE中Projectile相关事项
ue5·游戏引擎·虚幻·虚幻引擎·unreal engine
污领巾2 天前
虚幻GAS底层原理解剖一(开篇)
游戏引擎·虚幻
污领巾2 天前
虚幻GAS底层原理解剖三 (GA)
java·游戏引擎·虚幻