跳转到正文

初始设置

本文讨论了通用游戏技能系统(GGA)这一免费插件的基础设置。

创建时间: 2025年4月10日更新时间: 2026年11月03日

前置知识

目前的文档暂时假设你已经了解了GAS,后续的文档更新,会对GAS 0经验的用户更加友好。

在使用GGA之前,确保你对GAS有一个基本的了解,现在网络上已经有很多资源能够了解和学习到GAS,我推荐下面几个:

  1. Gameplay Ability System 官方文档
  2. GASDocumentation 这个世界上最详细的GAS文档

同样推荐你了解一下如下主题:

  1. Gameplay Tags 游戏性标签,必学啊。
  2. Gameplay Targeting System 官方新出的,数据驱动的检测目标的系统。

本插件并非试图掩盖 GAS 的复杂性或期望用户**避免 C++**。

它旨在为用户提供一个起点,让他们发现 GAS 的好处,然后在时机成熟时,再深入了解 GAS 背后的原理。

别忘了看看我对 GAS 概念的一些理解:GAS概念

项目设置

通过 Fab / Epic Games Launcher 安装插件并在项目中启用,或者将插件放入项目的 Plugins 目录。独立 GGA 不包含示例项目或玩法资产;如果你使用的 GCS 已包含 GGA,请不要再安装一份独立插件。当前项目基于 UE 5.8,最低支持 UE 5.8。

蓝图项目

只需在你的项目中启用该插件即可。

C++项目

确保在你的项目主要模块中,引用所需的模块。

全局配置

如果需要 GGA 的类型化 Effect Context 等全局扩展,在项目的 Config/DefaultGame.ini 中配置 GGA 的 AbilitySystemGlobals:

ini
[/Script/GameplayAbilities.AbilitySystemGlobals]
AbilitySystemGlobalsClassName="/Script/GenericGameplayAbilities.GGA_AbilitySystemGlobals"

在UE5.5及以上版本,你可以在项目设置中通过图形化的方式配置AbilitySysytemGlobals的默认配置。

完成第一次技能激活

  1. 在角色或其 Owner 上添加 GGA_AbilitySystemComponent。Owner 和 Avatar 可以是同一个 Actor;多人游戏中在服务端和需要使用 ASC 的客户端分别准备有效的 Owner / Avatar,并在合适的生命周期调用 InitializeAbilitySystem。
  2. 创建继承自 GGA_GameplayAbility 的技能蓝图,实现激活和结束逻辑。新手可以先用 Instanced Per Actor。
  3. 创建 GGA_AbilitySet 数据资产,加入该技能;将其配置为 ASC 的默认技能集,或在服务端通过 AbilitySet 的授予接口动态授予并保存返回的 handles。
  4. 在游戏中通过 ASC 激活已授予的技能,检查技能是否执行并结束。多人项目还应分别检查服务端和客户端;如果无法激活,先检查 Actor Info、授予是否发生在服务端,以及技能的标签、消耗和冷却条件。

按项目需要清理动态授予的内容。详细说明见技能系统组件和游戏技能基础;属性集生成需要 C++ 项目及编译环境,见属性集代码生成。