Surreal Engine

Unreal Engine 1 (UE1) 清洁室重实现，支持 Unreal / Unreal Tournament (UT99)

基本信息

核心技术点

清洁室重实现架构

• 完全从头重写，不使用原始 Epic 源码
• SHA1 数据库识别游戏版本（UE1GameDatabase），通过检测 System 目录可执行文件 SHA1 匹配已知游戏版本
• 支持 10+ 款 UE1 游戏检测，但仅有 UT436 和 Unreal Gold v226 达到可玩状态

双渲染器架构

• D3D11 (RenderDevice/D3D11/) — Direct3D 11 渲染器
• Vulkan (RenderDevice/Vulkan/) — 现代 Vulkan 实现
• 注意：与 UZDoom/ZDoom 不同，没有 OpenGL 渲染器（Status.md 明确标注 "There is no OpenGL renderer"）
• Vulkan 后端使用完整的 DescriptorSet/CommandBuffer/Framebuffer/Sampler 管理层

多窗口系统 (SurrealWidgets)

• SurrealWidgets/ — 跨平台 UI 组件框架
• 支持 SDL2 后端和 Wayland 原生后端
• 三套应用入口：SurrealEngine（游戏）、SurrealEditor（编辑器）、SurrealDebugger（调试器）

Unrealscript VM（部分实现）

• VM/ — 字节码解释器 (Bytecode.cpp)、表达式求值 (ExpressionEvaluator.cpp)
• NativeFunc.cpp — 原生函数桩（尚未完整实现）
• 缺失功能：数组支持、网络条件执行、大量 native 函数桩 → Bot AI 和脚本 Pawn 无法正常工作

模块化子系统

第三方依赖

• ZVulkan — Vulkan 头文件/绑定封装（子模块）
• openmpt — MOD/IT/XM tracker 音乐播放
• openal-soft — Windows 专用音频后端（Linux 无此依赖）
• SurrealWidgets — 自包含 UI 组件框架

构建流程

mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j 16
# 产出: SurrealEngine, SurrealEditor, SurrealDebugger

当前状态与已知限制

可玩游戏

• ✅ Unreal Tournament v436 — 相对可玩
• ✅ Unreal Gold v226 — 相对可玩
• ⚠️ 其他版本可能崩溃

重大缺失（Status.md 标注）

• 无 OpenGL 渲染器
• 无网络支持（完全缺失）
• Unrealscript VM 未完成（数组/网络条件执行）
• Mover 物理行为不准确
• 无动态光照
• Bot AI 不完整（只有受攻击反击和拾取物品）
• 反射/Portal 渲染有 bug
• 存档功能不完整
• 原生 mod 完全不支持（by design）

对公司 AI 游戏的参考价值