UE5 - 自定义Actor组件的创建与使用详解(附样例)
作者:hangge | 2025-09-24 09:09
在 UE5 中,Actor 组件(Actor Component)是将通用功能或逻辑拆分、模块化的核心手段之一。创建一个 Actor 组件后可以将此组件挂载到任意 Actor 上。例如:将背包系统的逻辑写入 Actor 组件后为所有存在背包的 Actor 添加此组件,就可以避免在每个需要背包的 Actor 中重复写入背包系统。









Actor 组件的界面和正常 Actor 蓝图相比,除了视口消失外,其他的几乎无异,在 Actor 组件中可以写出自己的逻辑。下面我将通过样例演示如何创建一个 Actor 组件,以及如何使用这个 Actor 组件。
1,创建 Actor 组件
(1)在“内容浏览器”面板中单击鼠标右键,执行“蓝图类”菜单命令,在“选取父类”对话框中选择“Actor 组件”选项即可创建 Actor 组件。

(2)假设我们这里创建了一个名为 BP_ActorComponent 的 Actor 组件。

2,在 Actor 组件中添加变量与函数
(1)双击“BP_ActorComponent”蓝图,在 Actor 组件中添加变量与函数的方法和在普通蓝图中完全一致:
- 在“我的蓝图”面板中单击“变量”按钮新建一个变量并命名为“Health”,设置“类型”为“浮点”。
- 单击“函数”按钮田新建一个函数并命名为“OnDamage”

(2)选择刚创建的 OnDamage 函数后在“细节”面板中单击“输入”右侧的“新建输入参数”按钮新建一个输入值并命名为“Damage”,设置“类型”为“浮点”

(3)将“Health”变量拖曳到“事件图表”面板中,在调用“OnDamage"函数时将“Health”变量的值设置为 Health 减 Damage 的结果,也就是在每次调用“OnDamage”函数时都会修改“Health"变量的值。

3,在 Actor 中应用 Actor 组件
(1)Actor、Pawn 或 Character 等 Actor 的派生类蓝图都可以安装 Actor 组件,新建一个“Actor”类蓝图并命名为“BP_Actor”

(2)双击进入“BP_Actor” 蓝图,在“组件”面板中单击“添加"按钮选择我们前面创建的 Actor 组件。

(3)选择新建的 Actor 组件,在“细节”面板中可以找到“Health"变量,每个对象都有一个单独的 Actor 组件,可以在不同的蓝图中进行不同的设置。现在设置该蓝图的“Health”为 100.0。

(4)在“组件”面板中拖曳新建的“BPActor Component”组件到“事件图表”面板中,拖曳输出引引脚到空白处后调用“OnDamage”函数,设置“Damage”为 15.0。使用“打印字符串”节点输出“Health”变量的值。

(5)最后在“内容浏览嚣”面板中拖曳“BP_Actor”蓝图到关卡中,运行程序,若左上角出现 85.0,则代表操作正确。

全部评论(0)