前置知识
目前的文档暂时假设你已经了解了GAS,后续的文档更新,会对GAS 0经验的用户更加友好。
在使用GGA之前,确保你对GAS有一个基本的了解,现在网络上已经有很多资源能够了解和学习到GAS,我推荐下面几个:
- Gameplay Ability System 官方文档
- GASDocumentation 这个世界上最详细的GAS文档
同样推荐你了解一下如下主题:
- Gameplay Tags 游戏性标签,必学啊。
- 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
在UE5.5及以上版本,你可以在项目设置中通过图形化的方式配置AbilitySysytemGlobals的默认配置。
完成第一次技能激活
- 在角色或其 Owner 上添加
GGA_AbilitySystemComponent。Owner 和 Avatar 可以是同一个 Actor;多人游戏中在服务端和需要使用 ASC 的客户端分别准备有效的 Owner / Avatar,并在合适的生命周期调用InitializeAbilitySystem。 - 创建继承自
GGA_GameplayAbility的技能蓝图,实现激活和结束逻辑。新手可以先用 Instanced Per Actor。 - 创建
GGA_AbilitySet数据资产,加入该技能;将其配置为 ASC 的默认技能集,或在服务端通过 AbilitySet 的授予接口动态授予并保存返回的 handles。 - 在游戏中通过 ASC 激活已授予的技能,检查技能是否执行并结束。多人项目还应分别检查服务端和客户端;如果无法激活,先检查 Actor Info、授予是否发生在服务端,以及技能的标签、消耗和冷却条件。
按项目需要清理动态授予的内容。详细说明见技能系统组件和游戏技能基础;属性集生成需要 C++ 项目及编译环境,见属性集代码生成。