Lyra - Plugins

ModularGameplayActors

作用

• Lyra 里的插件 ModularGameplayActors 是整个架构的一个核心部分，用来实现 角色、控制器、HUD 等 Gameplay 类的模块化（Modular）构建机制。它是 Lyra “模块化组件系统” 的基础，支持你以“插件化方式”给 Actor 添加功能，而不是通过硬继承和写死逻辑。

模块化系统的核心目标

传统方式的问题：

• 你通常会在 MyCharacter、MyPlayerController、MyHUD 里硬编码各种行为，比如：初始化输入/初始化技能系统组件/初始化 UI 控制逻辑
• 但这样：很难复用/不利于热更、插件式内容扩展/玩家控制器和角色之间的耦合度太高

ModularGameplayActors 将这些逻辑解耦成一个个“模块化组件”，通过注册自动注入到对应 Actor（如 Pawn, Controller, HUD）中。

此插件的主要功能

1. 模块化 Actor 生命周期管理：支持在特定时机（如 Controller 初始化、Pawn Possess 等）注册模块组件
2. 动态挂载组件：可以在运行时给 Pawn/Controller 添加组件（如 ULyraHeroComponent）
3. 支持 GameFeature 插件动态注册组件：GameFeature 激活时可以给现有 Actor 动态添加模块逻辑
4. 按类型分组扩展点：拥有像 ExtensionEvent-BindInputsNow、OnPawnExtensionAdded 等事件点

核心类说明

1. UGameFrameworkComponentManager

   • 它负责监听 Pawn、Controller、HUD 等的创建事件，并调用注册的扩展。

   • 这个语句会触发所有注册到该事件的组件（如 ULyraHeroComponent）执行绑定。

     1	UGameFrameworkComponentManager::SendGameFrameworkComponentExtensionEvent(Pawn, NAME_BindInputsNow);

2. UModularPawn / UModularPlayerController 等

   • 这些是 Lyra 扩展出来的基类，继承自引擎默认的 APawn / APlayerController 等。

   • 它们的特点：

     • 自动调用 UGameFrameworkComponentManager 的初始化逻辑
     • 支持组件注册、事件派发等