基于本地原版资源与 PPSSPP 运行时证据，恢复角色、材质、动作及场景，再迁移到 Unreal Engine 5.8 / C++。UE M1 已接入单敌人的可玩战斗循环；完整章节、高清美术与 cooked 独立发行仍在开发。
- 当前状态与下一步：已验证范围、已知失败、优先任务。
- 开发环境与运行：纯源码检查、C 原型、UE 构建。
- 运行包下载与安装：GitHub Release、资产同步及 SHA-256 校验方法。
- 协作约定：分支、PR、数据与验证记录。
- 架构与入口：模块职责、坐标与矩阵约束。
| 目录 | 职责 |
|---|---|
work/psp_parse/tools/ |
ISO/容器、CLUT/FEP、EBOOT/PRX 分析及 PPSSPP CPU/GE 采集工具 |
work/psp_parse/docs/ |
解析报告及历史交接记录 |
work/psp_parse/archive/ |
早期工具及部分被现有工具引用的辅助模块 |
work/t3b_hd/ |
C + SDL2 + OpenGL 2.1 战斗验证原型 |
work/t3b_unreal/ |
UE5 正式迁移工程、独立数值 core、导入与验证工具 |
docs/evidence/ |
本机既有构建/失败报告的交接快照，非 CI 结果 |
需要 Python 3.10+ 和支持 C++17 的 g++：
python -X utf8 scripts/check_source.py该命令检查 Python 语法，并运行 57 项 source-data、29 项动作兼容性/循环、41 项碰撞测试，共 127 项；不会启动游戏、安装引擎或读取 ISO。GitHub Actions 运行相同入口。它不覆盖 UE 编译、画面或可玩验收。
UE M1 v4 使用 Aya 的 44 source bones、同步原版枪械、一个原版 Twisted 和 140-draw 街景。已接入场景胶囊碰撞、越肩相机遮挡、锁定、真实枪口射线、逐姿态敌人三角形命中、受击/死亡、敌人追击/近战、装填和 Overdive 镜头返回。Aya 与武器共用动作时间，保留 v3 的材质遮挡修复。
本机 UE 5.8.4 最终模块的严格 NullRHI / D3D11 战斗检查均 14 项通过；D3D11 记录为 4 shots / 4 hits / enemy HP 0、Overdive 1 次返回，外侧 Overdive 镜头已目视确认无穿躯体。v4 全新 clone 安装、重复安装、655 资产校验、D3D11 / NullRHI 战斗和 source probe 均已通过。碰撞、AI、伤害和 Overdive 是 PC M1 适配规则，完整原版系统尚未恢复。
Git 源码树包含源码、工具、技术文档和资产身份清单；运行所需的模型、贴图、UE Content 与预编译项目模块由 Release 单独提供。原版 ISO、EBOOT/PRX、存档和内存/GE 转储留在本地。来源与依赖见 来源说明。
各子目录 README 和 CONTINUATION_CHECKPOINT.md 保留大量历史记录；当前状态以 docs/CURRENT_STATUS.md 为准。
v4 运行包已在 GitHub Release 发布，并已从公开链接下载校验。安装到 clone 后执行 scripts/run_unreal.ps1 -Game 进入 UE 战斗，-Game -ReplayOnly 进入源数据诊断回放；C 对照原型仍用 scripts/run_m1.ps1。UE 运行需要匹配的 UE Editor host。具体校验、引擎版本与命令见运行包交接。