虚幻引擎5文档已被迁移至 Epic开发者社区

Unreal Engine 4.26

Unreal Engine 4.27

Unreal Engine 5.0

Unreal Engine 5.1

Unreal Engine 5.2

Unreal Engine 5.3

> 编程和脚本编写 > 蓝图可视化脚本 > 脚本编写基础 > 事件（Events）

Light Theme

Dark Theme

事件（Events）

从游戏性代码中调用的节点，在 EventGraph 中开始执行个体网络。

Choose your operating system:

Windows

macOS

Linux

Event Level Reset

此蓝图事件节点仅在关卡蓝图中可用。

此蓝图事件节点仅在服务器上执行。在单人游戏中，本地客户端即视为服务器。

Level Reset 事件在关卡重启时发出执行信号。它在关卡重新加载后进行某项触发时非常实用。如玩家角色已死亡，但关卡无需重新加载时。

Event Actor Begin Overlap

多项条件同时满足时，将执行该事件：

Actor 之间的碰撞响应必须允许重叠。
执行事件的两个 Actor 的 Generate Overlap Events 均设为 true。
最后，两个 Actor 的碰撞开始重叠；两者移到一起或其中一个创建时与另一个重叠。

关于碰撞详细信息，请查阅：碰撞响应。

此蓝图 Actor 和保存在 Player Actor 变量中的 Actor 重叠时，它将增加 Counter 整数变量。


项目	描述
输出引脚
Other Actor	Actor - 这是与此蓝图发生重叠的 Actor。

Event Actor End Overlap

多项条件同时满足时，将执行该事件：

Actor 之间的碰撞响应必须允许重叠。
执行事件的两个 Actor 的 Generate Overlap Events 均设为 true。
最后，两个 Actor 的碰撞停止重叠；它们将分离，或在其中一个将被销毁。

关于碰撞详细信息，请查阅：碰撞响应。

当此蓝图 Actor 不与其他 Actor 发生重叠时（保存在 Player Actor 变量中的 Actor 除外），它将销毁重叠的 Actor。


项目	描述
输出引脚
Other Actor	Actor - 这是与此蓝图发生重叠的 Actor。

Event Hit

只要其中一个相关 Actor 的碰撞设置中 Simulation Generates Hit Events 设为 true，该事件便会执行。

如您使用 Sweeps 创建运动，即使未选中标记也将获得此事件。只要 Sweep 阻止您移过阻挡物体，这便会发生。


项目	描述
输出引脚
My Comp	原始组件 - 被命中的执行 Actor 上的组件。
Other	Actor - 参与碰撞的其他 Actor。
Other Comp	原始组件 - 参与碰撞，被命中的其他 Actor 上的组件。
Self Moved	布尔型 - 接受来自另一个物体运动的命中时使用（如为 false），对 Hit Normal 和 Hit Impact Normal 的方向进行调整，以便表现其他物体对被命中物体施加的力。
Hit Location	矢量 - 两个碰撞 Actor 之间的接触位置。
Hit Normal	矢量 - 碰撞方向。
Normal Impulse	矢量 - Actor 碰撞的力。
Hit	命中结果结构体 - 一次命中中收集到的所有数据，可剥离并"打破"该结果，访问数据的单个位元。

Hit

Event Any Damage

此蓝图事件节点仅在服务器上执行。在单人游戏中，本地客户端即视为服务器。

此事件在造成整体伤害时出现。如溺死或环境伤害，并非点伤害或放射伤害。


项目	描述
输出引脚
Damage	浮点型 - 传入 Actor 的伤害量。
Damage Type	伤害类型对象 - 这是在输出伤害上包含额外数据的对象。
Instigated By	Actor - 负责伤害的 Actor。这就是开枪或投手雷造成伤害的 Actor。
Damage Causer	Actor - 输出伤害的 Actor。这可以是子弹或爆炸。

此处，如果对 Actor 造成的伤害来自水，将减少体力值并在屏幕上生成警告。

Event Point Damage

此蓝图事件节点仅在服务器上执行。在单人游戏中，本地客户端即视为服务器。

点伤害（Point Damage） 代表由投射物、扫射武器、甚至近战武器造成的伤害。


项目	描述
输出引脚
Damage	浮点型 - 传入 Actor 的伤害量。
Damage Type	伤害类型对象 - 这是在输出伤害上包含额外数据的对象。
Hit Location	矢量 - 应用伤害的位置。
Hit Normal	矢量 - 碰撞方向。
Hit Component	原始组件 - 被命中的执行 Actor 上的组件。
Bone Name	名称 - 命中的骨骼名称。
Shot from Direction	矢量 - 伤害来源的方向。
Instigated By	Actor - 负责伤害的 Actor。这是开枪或投手雷造成伤害的 Actor。
Damage Causer	Actor - 输出伤害的 Actor。这可以是子弹或爆炸。

在此例中，受到任意伤害时均会从 Actor 的体力值减去造成的伤害。但如果 Actor 的头部被击中，则 Actor 的体力值设为 -1。

Event Radial Damage

此蓝图事件节点仅在服务器上执行。在单人游戏中，本地客户端即视为服务器。

放射伤害（Radial Damage） 事件在该序列的父 Actor 受到放射伤害时调用。这可用于处理基于爆炸伤害或间接伤害的事件。


项目	描述
输出引脚
Damage Received	浮点型 - 从事件接收的伤害量。
Damage Type	伤害类型对象 - 这是在输出伤害上包含额外数据的对象。
Origin	矢量 - 3D 空间中的伤害来源位置。
Hit Info	命中结果结构体 - 一次命中中收集到的所有数据，可剥离并"打破"该结果，访问数据的单个位元。
Instigated By	控制器 - 发起伤害的控制器（AI 或玩家）。
Damage Causer	Actor - 输出伤害的 Actor。可以是子弹、火箭、激光或角色的拳击。