深渊引擎（Abyss Engine）：C 语言编写的《暗黑破坏神2》洁净室重实现

Abyss Engine 是一个采用洁净室（clean-room）方式、使用 C 语言从零重写《暗黑破坏神2》（Diablo II）游戏引擎的开源项目。其核心目标并非简单复刻原作，而是将原版引擎移植到一个可移植性更强的平台上，同时让模组制作与功能扩展变得更加容易。

需要特别说明的是，本项目不是逆向工程项目，开发过程中没有使用任何原作代码。官方也明确指出，引擎不兼容原版游戏的存档文件与多人联机系统。这意味着它更像是一个面向未来的、可改造的引擎基础，而非原版游戏的直接替代品。

项目通过 IRC 频道 #AbyssEngine（位于 irc.libera.chat）进行社区交流，官方已不再维护 Discord 存在，任何相关服务器均与本项目无关。

构建指南

前置条件

在开始构建之前，请确保你的开发环境满足以下要求：

• CMake 3.20 或更高版本
• 符合 C99 标准的编译器（如 GCC、Clang 或 MSVC）

克隆仓库时，请务必递归拉取子模块：

git submodule update --init --recursive

编译方式

项目提供了多种编译途径，可根据你使用的开发环境选择：

• Visual Studio 2022 / CLion / VSCode（配合 CMake Tools 扩展）：直接在 IDE 中打开项目根目录并构建解决方案即可。
• Xcode：先通过 CMake 生成 Xcode 工程，再加载构建：

mkdir build
cd build
cmake .. -G Xcode

• 命令行：

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release

运行引擎

编译完成后，不同平台的运行方式略有差异：

• Linux 与 Windows：直接执行构建目录中的 abyss 可执行文件。
• macOS：执行构建目录中的 Abyss Engine.app 应用包。

请注意，引擎运行前必须正确配置 abyss.ini 文件，否则无法启动。

输出日志

从命令行运行 AbyssEngine 时，日志会直接输出到控制台。在 macOS 上，你需要直接运行应用包内部的二进制文件才能看到日志：

./AbyssEngine.app/Contents/MacOS/AbyssEngine

技术要点与定位

Abyss Engine 使用纯 C 语言实现，遵循 C99 标准，构建系统基于 CMake。项目采用洁净室开发方式，强调代码的原创性与可移植性。其设计目标包括：

• 在 Windows、macOS、Linux 等多平台上提供一致的运行体验；
• 为模组制作者提供易于扩展的引擎架构；
• 不依赖原版代码，规避法律风险。

由于引擎需要读取原版 MPQ 资源文件，它实际上是一个“引擎重实现 + 原版资源”的组合方案。这也意味着它无法脱离原版游戏资源独立运行。