概述
GGA同时还有另外一个代码模块,叫GenericGameplayAttribute。它主要负责对GAS系统中GameplayAttribute这块进行一定拓展,并包含了一些内置的GameplayAttributeSet 以及 AttributeSet代码生成器。这个模块非常轻量。
属性与Tag映射
GAS非常拥抱GameplayTags,然而GameplayAttribute并不是由GameplayTag驱动的,为此,GGA提供了可选的GameplayAttribute到GameplayTag的映射功能。
你可以通过Tag拿到Attribute,你也可以通过Attribute拿到Tag。
你也可以在运行时注册Attribute到某个Tag(这个操作是全局的)。
内置属性
GenericGameplayAttributes模块自带了三个比较常用的属性集,分别是AS_Health,AS_Mana,以及AS_Stamina。
你可以使用它,也可以不使用。它足够抽象,且是自动生成的(见下文)。
如何设计AttributeSet
如果你参考网络上的各种案例,教程,你会发现,大家习惯于使用一个AttributeSet,把游戏中所有用到的属性都定义在其中,而且会在AttributeSet中写很多游戏性逻辑,我认为这是不可取的。
相反,我认为AttributeSet应该根据游戏中的功能进行划分,且仅仅是起数据定义作用,不需要包含游戏逻辑,只需要在外部根据属性变化进行逻辑处理。
假定你的游戏中,需要Health,和Stamina两种属性,你应该定义两个AttributeSet。
AS_Health(生命属性集)
AS_Stamina(体力属性集)
这样做的好处是:
- 在多人游戏中,不同的角色可能需要的属性是不一样的,为了避免大量的网络同步消耗,你应该只给需要的角色所需的属性集。
- 同时这种模块化的设计,能够在未来走得更远。(比如你使用GameFeature,你的某一个子Feature定义了它专用的属性集)
不要滥用GameplayAttributes,这里有一个很棒的文章教你如何用少量的属性,完成复杂的任务。
关于代码生成
GGA提供了代码生成功能帮助你生成C++的AttributeSet代码。
即便是对于C++用户来说,添加新属性也是一个非常繁琐的过程,需要手写很多样板代码。
要使用代码生成功能,你需要安装Windows平台上的VisualStudio或者Mac平台上的XCode(请参考官方文档),并将你的项目转换成代码项目。
当前版本的生成流程
- 使用 C++ 项目,并安装 Windows 上的 Visual Studio 或 Mac 上的 Xcode 编译环境。在项目设置的 GGA AttributeSet Generator 中检查允许的目标路径。
- 创建 AttributeSet Definition,选择项目中的 Runtime 目标模块、输出布局和允许的子路径,设置类名、父类及属性。属性可按需配置复制、蓝图访问器、Gameplay Tag、最小值和关联的最大属性。
- 查看生成路径和依赖提示,先验证定义,再生成代码。目标文件已存在时,重新生成会覆盖它们,并在项目 Saved 目录下创建备份;请先检查自己的手工修改。
- 根据提示补齐目标模块的
.Build.cs依赖,然后编译项目。生成的是 C++ AttributeSet 和可选的蓝图访问函数,不是自动创建蓝图资产。
下方截图和代码保留作历史示例,具体界面和生成结果以当前版本为准。
代码生成指南
新增属性集的步骤:
- 创建新的属性集定义资产:在项目浏览器的空白处右键->GenericGameplayAbilities->CoreConfig->AttributeSetDefinition
- 命名新的属性集资产:建议以ASDefinition_为前缀命名新建的属性集定义,比如ASDefinition_Health|Combat|Stamina
- 进行代码生成配置:指定代码在哪个项目模块及其路径中生成,代码文件名,具备的属性等,也可以从模板下拉列表中选择阈值的模板帮你快速填充配置。
- 点击生成/重新生成按钮,代码生成完毕后,需要重新编译项目。
提示
你可以在项目设置->GGA Attribute Set Generator设置中,添加其它的可允许的代码子路径列表,比如“MyFolder/Attributes”,默认情况下,只允许模块名/Attributes|AttributeSets两个文件夹。
生成的代码
这是上面的配置会生成的代码:
如你所见,只是一个简单的属性集,就需要这么多代码。所以代码生成是必然的选择!
蓝图访问函数示例
一些思考
由于GAS的属性系统必须在C++完成,所以这阻碍了很大一部分的蓝图用户,同时虚幻商城中也出现了各种针对蓝图用户的解决方案。甚至出现了纯蓝图的GameplayAttribute解决方案。
但我认为,如果只是因为对代码项目产生恐惧,而绕了一个大弯去用各种黑科技来使用GameplayAttribute,我认为是本末倒置了。万一未来虚幻自带了GameplayAttribute的蓝图支持?万一未来虚幻团队让GAS不再必须使用C++?