游戏引擎 / 系统课时

用UMG显示血条和信息

用UMG显示血条和信息

这一课把角色内部的生命值等 Gameplay 状态转换成稳定、可读的 HUD。重点不是把数字“绑定到屏幕上”,而是明确谁创建 Widget、谁保存状态、什么时候刷新界面,避免 UI 每帧轮询或直接反向控制角色逻辑。

学习目标

  • 建立 Gameplay 状态到 UMG 控件的单向数据流
  • 创建并持有 HUD Widget,正确初始化进度条和文本
  • 用状态变化事件刷新界面,并验证零值、换 Pawn 等边界

先分清状态与界面职责

生命值应保存在 Character、PlayerState、AttributeSet 等 Gameplay 对象中,Widget 只负责显示。PlayerController 或 HUD 更适合负责创建并持有本地玩家的顶层 Widget,因为它们比 Pawn 更适合处理“当前正在观察哪个角色”的切换。

Gameplay状态到UMG界面的单向数据流

这条单向链路让 UI 成为状态的投影。角色掉血时只修改 Gameplay 数据并发出变化通知,Widget 收到新值后更新控件;按钮、血条和文本不应该成为生命值的权威来源。

创建Widget并准备控件引用

在 WBP_HUD 中放置一个 ProgressBar 和需要的 TextBlock,给它们稳定命名,例如 HealthBar、HealthText,并勾选 Is Variable。若使用 C++ 基类,BindWidget 会按名字连接 Blueprint 中已有控件,名字或类型不一致时初始化就会失败。

片段示例:下面方法依赖 UStatusWidget 已继承 UUserWidget,并且 Blueprint 内存在同名的 ProgressBar 与 TextBlock。

cpp
#include "Components/ProgressBar.h"
#include "Components/TextBlock.h"

void UStatusWidget::UpdateHealth(float CurrentHealth, float MaxHealth)
{
    const float SafeMax = FMath::Max(MaxHealth, 1.0f);
    const float Percent = FMath::Clamp(CurrentHealth / SafeMax, 0.0f, 1.0f);

    HealthBar->SetPercent(Percent);
    HealthText->SetText(FText::Format(
        NSLOCTEXT("HUD", "HealthFormat", "HP {0}/{1}"),
        FText::AsNumber(FMath::RoundToInt(CurrentHealth)),
        FText::AsNumber(FMath::RoundToInt(MaxHealth))
    ));
}

生效行为与验证方法:依次传入 100/100、60/100、0/100 时,血条比例应为 1.0、0.6、0.0,文本同步显示对应数值。MaxHealth 为 0 时也不会产生除零错误。

由本地控制器创建HUD

Blueprint 方案可以在本地 PlayerController 的 BeginPlay 中调用 Create Widget,Class 选择 WBP_HUD,Owning Player 传入自身,然后 Add to Viewport 并把返回值保存为成员变量。保存引用很重要,否则后续状态变化时只能重新查找甚至重复创建 Widget。

多人游戏中不要让服务器上的 Controller 试图创建客户端 HUD。创建前可检查 Is Local Controller;如果玩家死亡后会重新生成 Pawn,则在 OnPossess 或等价的 Pawn 变化流程中重新订阅新 Pawn,并先解除旧对象的事件绑定。

用事件驱动刷新状态

不要为了省事给血条做一个每帧执行的 Property Binding,再从 Widget 里不断 Get Player Character -> Get Health。少量控件时看起来能工作,但 Widget 多起来后会制造持续的跨对象查询,也让更新时机难以调试。

更稳妥的做法是让状态拥有者提供 OnHealthChanged 一类 Event Dispatcher 或 C++ Delegate。PlayerController 或 Widget 在初始化时订阅,生命值真正发生变化时才调用 UpdateHealth(Current, Max)。如果生命值是网络复制变量,则客户端应在 OnRep_Health、Gameplay Ability System 的属性变化委托等已经同步到本地的时机驱动 UI。

这种设计还能自然处理“观察其他角色”的需求:先解除旧角色订阅,再绑定新角色并做一次 Initial Sync,而不是让 Widget 猜当前屏幕应该读谁。

验证显示链路

在 PIE 中至少检查三条路径:满血进入关卡时 HUD 是否立即正确;受到一次伤害后血条和文本是否同时变化;Pawn 被重新 Possess 后是否仍能显示新 Pawn 的状态。若界面存在但数值不变,沿“状态是否修改 → 事件是否发出 → Widget 引用是否有效 → UpdateHealth 是否执行”的顺序排查,通常比从控件样式开始找更快。

当 Widget 只负责呈现、Controller 负责生命周期、Gameplay 对象负责真实状态后,UMG 就不会与角色逻辑缠在一起。之后增加护盾、弹药或任务提示时,只需继续沿同一条单向更新链路扩展。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用UMG显示血条和信息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通