UE5 多人 PVE Demo

项目简介

这是我从 Unity 工作流切换到 Unreal Engine 5 后完成的第一个游戏 Demo。项目基于 UE5.7 官方 First Person 模板开发，目标是在约三天内完成一个可以独立运行、打包并进行本地双人联机演示的战斗闭环。

玩家可以创建本地 Listen Server，另一名玩家通过本机地址加入。两名玩家进入训练场后共同对抗敌人：敌人会在服务器端寻找最近的存活玩家，基于 NavMesh 追击，并在攻击范围内播放动画和造成伤害；玩家使用第一人称射线武器攻击敌人，击杀会增加队伍分数，达到目标后所有玩家同步看到胜利提示。

这个项目不是完整商业化联机框架，而是一次小范围、可演示的 UE5 多人网络实践。我把重点放在题目要求的核心功能：敌人移动和攻击玩家、玩家击败敌人、基础得分与胜利机制，以及本地 Listen Server 双人联机流程。

核心玩法闭环

我的职责与贡献

本项目为独立开发。我负责从模板扩展、蓝图实现、多人同步、UI 到打包测试的完整流程。

• 扩展 First Person 模板，完成第一人称射击、射线反馈和服务器权威伤害判定。
• 实现玩家生命、死亡菜单、Owning Client RPC 显示逻辑和服务器重生流程。
• 搭建敌人血量、受伤、死亡、最近存活玩家索敌、NavMesh 追击和近战攻击。
• 使用 GameMode / GameState 维护队伍分数、目标分数和胜利状态。
• 实现 Listen Server 创建与加入、Lobby 人数判断和 ServerTravel 切图流程。
• 完成 HUD、准星、主菜单、死亡复活菜单和输入模式恢复。
• 整理 GitHub 仓库、技术说明 PDF、提交简述 PDF 和演示视频。

多人网络设计

项目使用 Listen Server 模式。与伤害、死亡、AI、重生、得分和胜利有关的核心状态由服务器统一处理；客户端主要负责输入、本地 UI 与即时视觉反馈。

玩家系统

玩家射击基于 First Person 模板扩展。按下鼠标左键后，客户端先执行 LocalFireVisual，本地绘制射线反馈，减少等待网络往返造成的迟滞感；随后调用 ServerFire RPC，由服务器根据第一人称摄像机位置和朝向执行 Line Trace By Channel。命中目标后，服务器调用 Apply Damage，对敌人造成伤害。

玩家角色维护 Health、MaxHealth 和 IsDead 变量，其中生命值和死亡状态设置为 Replicated。敌人攻击玩家时由服务器调用 Apply Damage。角色在 Event AnyDamage 中先判断 IsDead，避免死亡后重复扣血，并将生命值 Clamp 到有效范围。

当生命值归零时，服务器设置死亡状态，并调用 ClientShowDeathMenu。该事件设置为 Run on Owning Client，因此死亡菜单只会出现在死亡玩家自己的窗口中。点击复活后，客户端请求服务器恢复生命、重置死亡状态并传送至 PlayerStart。

敌人系统

敌人蓝图只在服务器 Authority 分支运行 AI。BeginPlay 中启动定时器，周期性调用 UpdateEnemy。该逻辑遍历所有玩家角色，跳过已经死亡的角色，选择距离最近的存活玩家作为目标，并使用 AI MoveTo 基于 NavMesh 追击。

进入攻击范围后，敌人使用 LastAttackTime 和 AttackCooldown 控制攻击频率。攻击触发时先调用 Multicast_PlayAttack，让所有客户端播放攻击动画；动画播放后延迟约 0.35 秒，再检查目标是否仍然有效且位于攻击范围内，然后执行 Apply Damage。

敌人生命归零后，服务器调用 GameMode 中的 EnemyKilled 增加队伍分数，再销毁敌人 Actor。这样敌人死亡、得分和胜利判断都由服务器统一处理，避免多个客户端分别计算导致状态不一致。

大厅、得分与胜利

主菜单包含单人游戏、创建多人游戏和加入游戏按钮。单人按钮直接打开战斗关卡；多人按钮通过 open /Game/Demo/Lvl_Lobby?listen 创建 Listen Server；加入按钮通过 open 127.0.0.1 连接本机服务器。

在 Lobby 中，BP_LobbyGameMode 通过 PostLogin 读取 GameState.PlayerArray 人数。当玩家数量达到 2 时，服务器执行 servertravel /Game/Demo/Lvl_FirstPerson，将所有客户端切换到战斗地图。

进入战斗地图后，GameMode 负责修改队伍得分；GameState 保存并复制 TeamScore、TargetScore 和 GameWon。当队伍击败 5 名敌人后，服务器设置胜利状态，所有客户端 HUD 同步显示胜利提示。

技术挑战与解决方式

打包阶段还遇到过中文路径、临时 C++ Target 和未使用插件带来的构建问题。最终通过将关键资源迁移至英文目录、关闭未使用插件，并使用 Windows Development 配置完成可执行版本测试。

结果与反思

最终版本完成了题目要求的核心闭环，并能通过两个独立 exe 窗口演示 Listen Server 双人联机。玩家生命、死亡重生、敌人 AI、攻击表现、队伍得分和胜利状态能够在两端保持一致。

这个项目让我从“在引擎中实现功能”进一步转向“决定功能应由哪一端执行、哪些状态需要复制、谁拥有 UI 与输入”的多人游戏思维。虽然项目规模较小，但它补足了我在 UE5、Blueprint、UMG 和网络同步方面的实践空白。

如果继续迭代，我会优先完善更完整的武器系统、敌人生成波次、关卡目标引导、UI 与场景视觉，以及更稳定的房间发现流程；部分高频逻辑迁移至 C++ 也会作为后续学习方向，而不是当前版本已经完成的内容。

演示视频

相关链接

• GitHub 仓库
• 可执行版本
• 演示视频
• 技术说明 PDF
• 提交简述 PDF