准备工作&项目迁移 | 虚幻引擎

概述

在开始使用通用库存系统（GIS）之前，需要完成以下准备工作以确保顺利集成和使用。本节介绍如何启用插件、获取配套项目、熟悉项目内容以及迁移到现有项目。

确保通过 Epic Launcher 安装 GenericInventorySystem 和 GenericGameSystem 插件，并在你的项目中启用它们。

通过Discord 验证购买以获取配套项目。验证后，你将获得一个完整项目，包含：

注意

请参考配套项目进行学习使用，里面的内容足够你了解GIS的运作方式，因此，文档无法对GIS的所有功能进行一比一还原。

建议结合本文档和配套项目一起学习，以快速掌握 GIS 的使用。

配套项目包含以下文件夹结构：

Column 1	Column 2
文件夹	描述
GenericGame/Shared	包含 UE5/4 Mannequins 资产、简单可复用的蓝图，以及来自 Epic 的免费素材（需遵守 Epic 的许可协议）。
GenericGame/CommonSystem	属于 GenericGameSystem，包括交互、相机、特效等资产。
GenericGame/InventorySystem/Core	GIS 的核心资产，不建议修改其内容，因为更新版本时可能被覆盖。
GenericGame/InventorySystem/Extras	GIS 的 UI 资产，包含各种可复用的 Widget 蓝图。
GenericDemo/GIS	GIS 的演示蓝图、角色和关卡，帮助快速学习，可在迁移时删除。

Note

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

在 GIS_Demo 关卡的 APIGraph 中可以找到所有可用的蓝图节点。

此外，BP_GIS_UnitTester 蓝图包含对各种 API 的测试内容，帮助你更清晰地理解其用法。

建议先熟悉 GIS_Demo 项目后再迁移到现有项目，以便更好地选择所需内容和排除不需要的内容。
如果是新项目，可直接以 GIS_Demo 为基础开始开发。

迁移到现有项目时，仅需 GenericGame 文件夹中的内容。可以使用 Epic 的迁移工具，或在文件浏览器中手动复制粘贴。

迁移 Config/Tags 下的所有 .ini 文件，并确保在项目设置的 GameplayTags 部分启用 ImportTagsFromConfig 选项。

迁移 DefaultGame.ini 中的设置，并检查 GIS_Demo.uproject 文件以确认应启用的插件。

GIS 将持续更新，每次代码发布新版本时，配套项目也会同步更新。
最简单的更新方式是重复上述迁移步骤。
但随着 GIS 的迭代，文件路径可能变更，新增功能可能引入，旧功能可能移除。为便于更新，建议：