开源《古墓丽影》1-5 引擎重制（OpenTomb）

设计动机

README 用专门一节解释了“为什么还要写一个新引擎”，理由主要有两点：

• 长期可运行性：虽然 TR2—5 有可用的 Windows 版本，TR1 也能通过 DosBox 运行，但随着操作系统演进，旧游戏的兼容性只会越来越差。开源引擎理论上可以移植到任何目标平台。
• 突破原版二进制限制：原版引擎存在 TREP、TRNG 等补丁工具，但它们始终受制于原始可执行文件。开源实现不受这一限制，在新增特性、画面增强和代码修改上空间更大。

项目希望在现代 PC 的 CPU 与显卡上重现经典《古墓丽影》的体验，同时加入当代的更新与扩展。

平台支持

README 明确说明 OpenTomb 是跨平台引擎，当前可在 Windows、Mac 与 Linux 上运行。移动端尚无开发计划，但作者认为技术上可行。

资源准备

要运行原版关卡，需要自备对应游戏的资源，且这些资源往往格式晦涩、各代之间还有差异。README 给出的准备方式包括：

• 数据目录：从零售光盘或 Steam/GOG 版本中取出各代的 data 文件夹，放入对应的 /data/tr*/ 目录，例如 TR3 为 OpenTomb/data/tr3/data/；Gold 版本放入 data/tr*_gold/。
• CD 音轨：引擎目前仅支持 OGG 音轨，需要自行转换，或从 README 给出的地址下载 TR1—5 音乐包；README 提醒文件可能需要重命名才能生效。
• 加载画面：TR1—3 与 TR5 的加载画面获取较麻烦（TR4 用关卡截图，TR5 使用加密格式），README 提供了现成的加载画面包下载地址，引擎支持 png 与 pcx 格式。

编译方式

源码附带 CMakeLists.txt，可用 CMake 构建。README 给出的要点：

• Windows：可用 CMake，也可在 Code::Blocks 或 Netbeans 中编译；手动编译需递归加入 /src 下所有源文件，并在链接器设置中加入 libmingw32、libSDL2main、libSDL2.dll、libpng、libz、libpthread 等库。
• Linux：下载源码后在终端执行 cmake . && make；依赖 SDL2、png、ZLIB 的开发头文件，Ubuntu 系可用 sudo apt-get install libopenal-dev libsdl2-dev libpng12-dev libglu1-mesa-dev zlib1g-dev 安装。
• Mac：使用源码中提供的 XCode 工程。

README 特别提醒：编译需要 C++11（-std=c++11）。可以使用 -march 等 CPU 优化参数与 -O1/-O2/-O3 优化级别，但旧版 GCC 使用 -O3 可能因 Bullet 导致崩溃，GCC 5.1+ 据称可正常编译。

运行与配置

构建完成后直接运行生成的可执行文件即可，默认无需命令行参数。按反引号键（）打开控制台，可输入命令选择关卡、修改设置，输入 help查看命令列表，输入exit` 退出。

配置由 config.lua 与 autoexec.lua 管理：前者保存持久的引擎与游戏设置，分为 screen、audio、render、controls、console、system 等区段；后者是启动时执行的命令列表，README 提醒随意修改可能导致引擎工作异常。

选择关卡使用 setgamef(game, level)，其中 game 为 1—5。庄园关卡通常为 0，没有庄园的作品从 1 开始；例如加载 TR3 第 2 关输入 setgamef(3, 2)。

学习建议

由于项目已停止维护，阅读时建议把它当作“如何从零重写一个经典 3D 动作冒险引擎”的案例：关注其房间碰撞网格生成思路、Lua 驱动的实体脚本化设计，以及基于 SDL/OpenGL/Bullet 的跨平台工程组织方式。若目标是实际制作或运行经典关卡，README 本身已建议转向 TombEngine。