Lyra - Game Feature

什么是GameFeature

Game Feature（游戏特性）是虚幻引擎中一个强大的插件系统，旨在实现高度模块化和可扩展的游戏开发。

想象一下，你可以像搭乐高积木一样构建你的游戏：角色的能力、新的游戏模式、季节性活动，甚至UI界面，都可以作为一个独立的“特性”插件来开发。当需要时，只需动态地激活这个插件，所有相关的功能、内容和逻辑就会自动应用到游戏中；不需要时，则可以随时停用，干净利落地移除，而不会影响游戏的核心代码。

这种方式极大地降低了团队协作的耦合度，让大型项目管理变得前所未有的清晰和高效。

简单理解就可以理解为游戏Mod把，加载了就有这块功能，卸载了就没有这块功能

创建一个GameFeature插件

1. 打开GameFeature插件

   

2. 在插件页面 点击 Add(添加) 根据是否需要c++ 创建GameFeature

   

3. 他会帮你默认创建一个 GameFeature的 PrimaryDataAsset，写好你需要的即可

4. 我们一定要打开项目设置查看下，这个是否加入，没有得补上去

   

5. 这样的话我们就创建好了，记得在插件设置里面启动你刚刚创建好的插件

Feature State

1. Installed：意味着该插件位于本地存储中（即位于硬盘上），但尚未注册、加载或激活。好比你买了一个游戏卡带，放在游戏机旁边，游戏机只知道你的卡带在哪里
2. Registered：已注册意味着插件中的资源已知，但尚未加载。好比你游戏卡带插进了游戏机，但是你还没有开始游戏
3. Loaded：已加载意味着插件已加载到内存中并注册到某些游戏系统，但尚未激活且不会影响游戏玩法。
4. Active：活动意味着插件已完全加载并处于活动状态。它的功能也影响了游戏玩法。

UGameFeatureData

在你创建好一个Feature后就会有该DataAsset，在里面填入这个GameFeature的数据

FeatureState

• Initial State: 显示当前插件状态，如果你在运行游戏的时候激活了，然后打开此DataAsset就会发现他变成了Active。后面的EditPlugin是可以让你修改此插件信息，比如插件信息，以及还有此插件依赖的其他插件
• Current State: 插件当前状态，可以手动设置默认状态
• GameplayTagConfigPath: 该插件的指定加载或存放 Gameplay Tags 的特定配置文件（.ini）路径。

GameFeature

• Actions: UGameFeatureAction类，专门用于在加载GameFeature的时候做的额外操作，比如 Add Component, 在加载的时候给类加上Component
• AssetManager：FPrimaryAssetTypeInfo结构体， 定义了规则、配置和源数据结构，用于告诉引擎如何识别、扫描、分配以及打包游戏中的各类资源

UGameFeatureAction

UGameFeatureAction 是你在加载 Gamefeature的时候可以顺便干的事，比如你可以给主角或者其他类 Add Componment，也可以自定义给主角添加特定能力(Ability)

重要接口

1. virtual void OnGameFeatureRegistering() override;

   当虚幻引擎启动并发现这个 Game Feature 插件时，会立即调用。

2. virtual void OnGameFeatureUnregistering() override;

   引擎关闭的时候，会立刻调用

3. virtual void OnGameFeatureActivating(FGameFeatureActivatingContext& Context) override;

   当游戏逻辑通过调用 UGameFeaturesSubsystem::Get().ActivateGameFeaturePlugin() 来主动激活这个插件时触发。这通常是游戏流程的一部分

4. virtual void OnGameFeatureDeactivating(FGameFeatureDeactivatingContext& Context) override;

   当游戏逻辑通过调用 UGameFeaturesSubsystem::Get().DeactivateGameFeaturePlugin() 来主动停用这个插件时触发

FPrimaryAssetTypeInfo

它不包含复杂的逻辑，而是定义了规则、配置和源数据结构，用于告诉引擎如何识别、扫描、分配以及打包游戏中的各类资源。

FPrimaryAssetTypeInfo

用于在项目设置中定义资源类型的一种扫描规则

• PrimaryAssetType：名称
• AssetBaseClass：选定这个资源类型的基类
• HasBlueprintClasses：如果是true，则也扫描该类的蓝图。反之，则只扫描 c++ 的实例资源
• IsEditorOnly：如果为true，则该资产永远不会被烘焙
• Directorires：资源所在的文件夹
• SpecificAssets：直接指定某些特定的资源路径，而不通过文件夹扫描
• Rules：FPrimaryAssetRules结构体，定义资源管理的核心规则

FPrimaryAssetRules

这是定义资源管理的核心规则

• Priority：当一个次要资源(如贴图)被多个主资源引用时，优先级绝对谁拥有它。高优先级会覆盖低优先级。如果优先级一样，共同管理
• ChunkId：用于分包下载或补丁管理。如果设置为0以上的，该资源及其依赖项会被放入指定的 .pak块中
• bApplyRecursively：如果为true，该规则不仅影响主资源本身，还会自动应用到它所引用的所有次要资源（除非那些资源被更高优先级的规则管理）
• CookRule：EPrimaryAssetCookRule 枚举，这个枚举定义了一个主资源在打包过程中的行为。它决定了资源是在开发环境还是生成环境中被包含。

EPrimaryAssetCookRule

FPrimaryAssetRules：这个枚举定义了一个主资源在打包过程中的行为。它决定了资源是在开发环境还是生产环境中被包含

• Unknown: 默认值。如果没有特殊规定，只要被其他资源引用，它就会被烘焙。
• NeverCook：绝对不烘焙，如果有引用该资源，直接报错
• ProductionNeverCook：如果有其他东西依赖于资产，资产将在开发中被烘焙，但永远不会在生产构建中被烘焙。
• DevelopmentAlwaysProductionNeverCook: 资产永远在开发的时候烘焙，即使没被引用。永远不会在生产构件中被烘焙
• DevelopmentAlwaysProductionUnknownCook：资产永远在开发中被烘焙；关于它是否应该在生产中烘焙尚不清楚。如果有其他东西依赖于它，它会在生产中烘焙。
• AlwaysCook：资产无论在什么环境都会被烘焙

注意

1. 可以主项目引用 GameFeature 里的资源 但是编译会报 Error Log，所以不推荐这么做，因为你用 GameFeature 的资源的时候，这个GameFeature可能未被加载。故只能GameFeature引用主项目这块