准备工作&内容迁移

Cover.GCS
罗传月武(YueWu)

作者

罗传月武(YueWu)

专注游戏开发和Web技术。

创建时间: 2025年4月15日更新时间: 2026年7月25日

目录

概述

一个战斗系统由多方面组成,且具备一定的学习成本。本文提供了通用战斗系统(GCS)的基本信息和准备工作指导,帮助用户快速上手并了解系统的运作方式。对于GCS的个别详细功能,建议参考专门的文档页面。

准备工作

启用插件

确保通过Epic Launcher安装GenericCombatSystem和GenericGameSystem,并在你的项目中启用。

准备工作.启用插件

插件兼容性

如果你通过EpicLauncher 单独安装了 Generic Gameplay Abilities and Generic Input System,请卸载掉它们,因为GCS包含它们。

验证购买

经过购买验证的用户,会获取一个完整项目,包含核心资产文件,额外资产,以及Demo。

请查看售后支持,购买验证。

熟悉项目结构

这是GCS提供项目的大体结构,在学习时,请结合文档和项目。

GCS准备工作.002
Column 1Column 2

文件夹

描述

GenericGame/Shared

包含UE5/4 Mannequins资产,和一些可复用的简单蓝图,以及一些来自Epic内容的免费素材(请遵循Epic的许可使用)

GenericGame/InputSystem/Core

内置的可复用输入检测器以及处理器。

GenericGame/CommonSystem/CameraExtras

内置的一些相机模式,可选内容。

GenericGame/CommonSystem/EffectsCore

战斗,脚步声VFX/SFX运行所需的蓝图。

GenericGame/CommonSystem/EffectsExtras

战斗,脚步声的 vfx/sfx 的预制设置。

GenericGame/CombatSystem/Core

GCS的核心资产,包含核心蓝图资产,以及可复用的技能。

GenericGame/CombatSystem/Extras

GCS的额外资产,包含了预定义的攻击定义,游戏效果,子弹配置,Targeting预设等。

GenericGame/CombatSystem/Integration

GCS针对Paragon资源,以及一些第三方动画包的集成文件(不含动画源文件)。

GenericDemo/GCS

提供基础的关卡,角色蓝图,武器等,用于展示如何使用GCS。

其他顶层文件夹

都是出于教学目的用到的一些来自Epic的免费资源,在迁移时可以完全删除。

迁移注意事项

尽量不要修改 GenericGame 文件夹下的内容,而是Copy提供的内容并进行修改,这样在更新时文件不会被覆盖。

同时也尽量不要修改 GenericDemo 文件夹下的内容,因为它仅用于参考,帮助你学习了解用法。如果你认为Demo的内容也能满足你的需求,那么你可以将将整个文件夹复制一份到别处并开始修改它。


迁移到你的项目

如果要迁移到现有项目,只有 “GenericGame ”文件夹中的所有内容是必须的。你可以通过Epic自带的迁移工具进行迁移,你也可以安全地直接在文件浏览器中手动复制粘贴。

同时,还需要迁移 Config/Tags 下的所有 .ini 文件,以及Config/DefaultGame.ini中的配置。

注意事项:

  1. 在迁移过程中,一些被剥离的第三方资产可能会弹出警告,你可以放心地忽略这些警告。
  2. 迁移后,要使脚步声生效,还需要在项目设置中添加 SurfaceTypeToContextMap(项目设置->游戏->GES 上下文效果设置)。
  3. 检查一下GCS_Demo.uproject确认哪些插件应该被启用。

更新到你的项目

每次更新插件后,你还需要更新对应的内容资产(如果有更新)。代码插件V1.1.X与提供的资产项目V1.1.x兼容,V1.2.x的代码插件与V1.2.x的内容兼容,以此类推。

如果你已经迁移了GenericGame到你的项目,你只需要关闭编辑器,然后删除Content/GenericGame,以及之前迁移过来的Tags.ini文件,然后重复上一步的迁移步骤即可。

如果有文件重命名,或者更改了文件夹架构,我都会提供资产/代码重定向配置,以确保不会丢失蓝图引用。

所以再次强调,Demo文件夹下的内容用于参考和学习,尽量不要直接使用。