Caution
- 不要直接git clone！！！直接Clone下来的文件夹大小高达80GB左右，直接git clone会消耗大量Git LFS带宽，因此有需要的部分可以自行选取下载，也可以到release去下载可以直接游玩的版本。
- 本游戏的美术资源均获取于网络，请勿商用
本项目参考同名游戏《黑神话·悟空》，基于Unreal Engine 5.4实现了一款第三人称动作冒险游戏。游戏以东方神话为主题，玩家操纵“悟空”角色，在3D场景中进行探索与战斗。项目实现了核心的战斗系统（攻击、闪避、法术）、敌人AI（普通怪物与Boss二郎神）、以及完整的游戏循环（存档、商店、场景切换）。
v0.1.0 目前仅在Windows11上测试运行过，注意采用了分卷压缩的形式。
项目主要目录结构如下：
- /docs
- 包含所有项目文档。
- /BlackMyth/Source/BlackMyth
- 核心代码库，包含所有 C++ 类实现：
/Components: 通用组件（生命、体力、背包、状态等）。/Combat: 战斗相关逻辑。/AI: 敌人行为树与控制器。/UI: 所有 Widget 的 C++ 后端逻辑。/Items: 道具类定义。
- 核心代码库，包含所有 C++ 类实现：
- /BlackMyth/Content
- 美术资产：包含模型、材质、动画、音效、蓝图等。
详见 项目说明文档
| 按键 | 功能描述 |
|---|---|
| W / A / S / D | 角色移动 |
| Shift (按住) | 疾跑 |
| 鼠标左键 | 轻击 |
| 鼠标右键 | 重击 |
| 鼠标中键 | 锁定敌人 |
| Ctrl | 翻滚 (躲避) |
| 空格 | 跳跃 |
| X | 立棍击打 |
| V | 甩花棍 (防御/连段) |
| F | 拾取金币 / 交互 |
| I | 打开背包 |
| 1 / 2 / 3 / 4 | 释放技能 / 使用背包道具 (打开背包后) |
Important
以下演示包含 gif 动图，请耐心等待加载完毕。
- Git 协作规范制定
- 明确分支管理策略
- 开始学习UE5.4的基础使用
- UE5 项目工程建立
- 导入基础资产
- 实现悟空基础移动（跑、跳）
- 实现基础攻击动作
- 引入 Paragon 资源包
- 抽象出
HealthComponent组件 - 抽象出
StaminaComponent组件 - 抽象出
CombatComponent组件 - 重构角色属性逻辑
- 实现生命值与体力值 UI
- 引入
EnemyBase基类 - 实现敌人基础感知 AI
- 实现敌人追踪 AI
- 增加项目设计架构文档
- 完善攻击判定（TraceHitbox）
- 修复连招 Bug
- 修复位移 Bug
- 重构角色蓝图
- 导入敌人模型与动画
- 实现混合空间（BlendSpace）
- 优化敌人追逐速度
- 初步实现主菜单并对后续功能完成规划
- 初步实现暂停菜单
- 初步实现存档/读档 UI 框架
- 增加敌人受击动画与音效
- 增加新敌人类型（斧头兵、剑兵）
- 实现视角锁定（Lock-on）功能
- 优化战斗手感
- 增加被锁定敌人的视觉提示
- 修复敌人视野 Bug
- 实现定身术技能
- 初步实现 NPC 对话系统
- 实现对话 UI 组件
- 增加新地图
- 存档系统功能实装
- 实现状态效果（中毒/减速）
- 变身术（蝴蝶）实装
- 优化 NPC 交互逻辑
- 增加背景音乐
- 二郎神 Boss 实装
- 实现 Boss 技能（召唤哮天犬）
- 实现 Boss 多阶段逻辑
- 背包系统上线
- 道具系统上线
- 土地庙交互功能实装
- 土地庙传送功能实装
- 安息术、立棍AOE重构
- Boss 战空气墙实装
- 优化 Boss 战斗体验
- 土地庙商店系统完成
- 金币掉落与拾取功能完成
- 死亡重生机制完善
- 修复 Boss 硬直 Bug
- 修正地图问题
- 移除 Debug 线条
- 项目收尾与最终合并
- 完成项目文档
2025年12月28日