概述
一个战斗系统由多方面组成,且具备一定的学习成本。本文提供了通用战斗系统(GCS)的基本信息和准备工作指导,帮助用户快速上手并了解系统的运作方式。对于GCS的个别详细功能,建议参考专门的文档页面。
准备工作
启用插件
确保通过Epic Launcher安装GenericCombatSystem
和GenericGameSystem
,并在你的项目中启用。

如果你通过EpicLauncher 单独安装了 Generic Gameplay Abilities and Generic Input System,请卸载掉它们,因为GCS包含它们。
验证购买
经过购买验证的用户,会获取一个完整项目,包含核心资产文件,额外资产,以及Demo。
请查看售后支持,购买验证。
熟悉项目结构
这是GCS提供项目的大体结构,在学习时,请结合文档和项目。

文件夹 | 描述 |
GenericGame/Shared | 包含UE5/4 Mannequins资产,和一些可复用的简单蓝图,以及一些来自Epic内容的免费素材(请遵循Epic的许可使用) |
GenericGame/AISystem | 内置的一些可复用的AI节点,满足基本AI制作需求。 |
GenericGame/CombatSystem | 内置的一些相机模式,可选内容。 |
GenericGame/EffectsSystem | Core:战斗VFX/SFX运行所需的蓝图。 Extras: vfx/sfx 的预制设置。 |
GenericGame/CombatSystem/Core | GCS的核心资产,包含核心蓝图资产,以及可复用的技能。 |
GenericGame/CombatSystem/Extras | GCS的额外资产,包含了预定义的攻击定义,游戏效果,子弹配置,Targeting预设等。 |
GenericDemo/GCS | 提供基础的关卡,角色蓝图,武器等,用于展示如何使用GCS。 |
其他顶层文件夹 | 都是出于教学目的用到的一些来自Epic的免费资源,在迁移时可以完全删除。 |
尽量不要修改 GenericGame 文件夹下的内容,而是Copy提供的内容并进行修改,这样在更新时文件不会被覆盖。
同时也尽量不要修改 GenericDemo 文件夹下的内容,因为它仅用于参考,帮助你学习了解用法。如果你认为Demo的内容也能满足你的需求,那么你可以将将整个文件夹复制一份到别处并开始修改它。
迁移到你的项目
如果要迁移到现有项目,只有 “GenericGame
”文件夹中的所有内容是必须的。你可以通过Epic自带的迁移工具进行迁移,你也可以安全地直接在文件浏览器中手动复制粘贴。
同时,还需要迁移 Config/Tags 下的所有 .ini 文件,以及Config/DefaultGame.ini中的配置。
注意事项:
- 在迁移过程中,一些被剥离的第三方资产可能会弹出警告,你可以放心地忽略这些警告。
- 迁移后,要使脚步声生效,还需要在项目设置中添加 SurfaceTypeToContextMap(项目设置->游戏->GES 上下文效果设置)。
- 检查一下GCS_Demo.uproject确认哪些插件应该被启用。
更新到你的项目
每次更新插件后,你还需要更新对应的内容资产(如果有更新)。代码插件V1.1.X与提供的资产项目V1.1.x兼容,V1.2.x的代码插件与V1.2.x的内容兼容,以此类推。
如果你已经迁移了GenericGame
到你的项目,你只需要关闭编辑器,然后删除Content/GenericGame,以及之前迁移过来的Tags.ini文件,然后重复上一步的迁移步骤即可。
如果有文件重命名,或者更改了文件夹架构,我都会提供资产/代码重定向配置,以确保不会丢失蓝图引用。
所以再次强调,Demo文件夹下的内容用于参考和学习,尽量不要直接使用。