Warsow 的 qfusion 游戏引擎（源自 id Tech 2 的跨平台 OpenGL 引擎）

qfusion 是源自 id Tech 2 的跨平台 OpenGL 游戏引擎，本仓库是 Warsow 项目所维护的分支源码。README 开篇即说明：这是 Warsow 对 qfusion 的 fork，而 qfusion 本身由 id Tech 2 演化而来。引擎以 C++ 编写，采用 GPLv2 许可发布，主页为 qfusion.net。

需要区分的是，本仓库提供的是引擎源码，而非可直接游玩的成品游戏。要真正运行，还需要配合 Warsow 2.6+ 的数据文件（basewsw 目录），README 建议前往 Warsow 官网或 Warsow Discord 获取相关细节。

构建准备

构建的第一步是连同子模块一起递归克隆仓库：

git clone --recursive https://github.com/Warsow/qfusion

随后需要进入 qfusion/third-party 目录，编译其中两个基于 CMake 的子项目：angelscript 与 openal-soft。README 明确指出，这一步在初次配置时执行一次即可。

此外，项目使用自定义的 Qt 静态构建。需要单独下载 Qt 5.13.2 源码包，README 给出了对应的 MD5 校验值（qt-everywhere-src-5.13.2.tar.xz 与 .zip 两种格式各一个）。无论目标平台是什么，都要先应用 README 中提供的 QML 垃圾回收修改补丁，该补丁涉及 qtdeclarative/src/qml/memory/qv4mm.cpp 与 qv4mm_p.h，主要改动是引入 qt_wswHeapSizeGCThreshold 变量并调整堆内存回收阈值的判断逻辑。

各平台构建要点

Linux

README 以解压并构建到 /opt/qt/ 为例。首先需要修改 qtbase/src/platformsupport/platformsupport.pro，在条件判断中加入 qtConfig(xkbcommon)。随后使用 README 给出的一长串特性开关配置 Qt：静态、release、开源版、桌面 OpenGL，并关闭大量不需要的模块与特性（如 gif、ico、libjpeg、tiff、webp、sql、dbus、egl、wayland、qtwebengine 等），同时跳过众多子模块。

配置完成后执行 gmake -j$(nproc) 与 gmake install。README 提示：若在“building qmake”阶段失败，需要修改相应源码/头文件，使其为现代工具链包含 <limits>。

Windows

Windows 下的 Qt 配置命令与 Linux 类似，但 README 注明“TODO: 参照 Linux 构建进一步裁剪特性”，即当前配置尚未完全精简。更多信息可参考 Qt 官方 Windows 构建文档。

构建与运行引擎

Qt 构建安装完成后（README 假设安装到 /opt/qt/5.13.2），在 qfusion/source 目录下执行 CMake 配置：

cmake -DQFUSION_GAME="Warsow" -DCMAKE_PREFIX_PATH=/opt/qt/5.13.2 .

README 强调两个关键变量：QFUSION_GAME 与 CMAKE_PREFIX_PATH，Windows 用户可借助任意 CMake 配置工具传入。随后执行 make -j$(nproc) 编译，生成的可执行文件位于 qfusion/source/build 子目录。

运行引擎时，需要在一个包含 basewsw 子目录的路径下启动，该目录存放 Warsow 2.6+ 的数据文件。