毁灭公爵3D 源代码（Duke Nukem 3D v1.5）

NakedAVP 是把 2000 年的《异形大战铁血战士 经典版》（Aliens Versus Predator Gold）搬到现代系统上的非官方移植项目。原作由 Rebellion Developments 开发、Fox Interactive 发行；本项目则以 icculus 早年发布的 Linux / macOS 移植代码为基础，把平台层迁移到 SDL3，并面向 Linux、macOS 与 Windows 三个平台。

需要先说明的是，这并非一个「开箱即玩」的完整游戏发行版：仓库只提供引擎源码与移植层，运行前必须自备原版游戏数据。README 中明确写着「Previously missing features are still missing. Multiplayer, etc.」——多人对战等在原移植中就没有完成的功能，这里依旧没有实现。

如果把项目拆开来看，它由三部分构成：一是当年游戏自身的引擎逻辑，二是 icculus 移植带来的跨平台外壳，三是本项目新引入的 SDL3 与 FFmpeg 依赖。对外部使用者来说，理解这三层的关系，比记住构建命令更重要。

技术要点

项目使用 C 语言编写，构建系统为 CMake，运行时依赖 SDL3、OpenAL 与 OpenGL，影片解码依赖 FFmpeg。几个容易被忽略的细节：

• FFmpeg 只用于 Bink 与 Smacker 影片解码，不参与游戏其它子系统；因此缺少影片文件时，游戏本体仍应能启动。
• FFmpeg 开发包必须提供 libavformat、libavcodec、libavutil、libswscale、libswresample 五个组件，且版本要求 5.1 或更新。
• CMake 配置阶段优先使用 pkg-config 查找依赖，同时也支持常规的头文件/库目录探测方式，便于在 pkg-config 不完善的平台上构建。
• 若发行版政策或授权要求，可使用仅含 LGPL 组件的 FFmpeg 构建。
• 在 Linux 上官方只支持 GCC 编译。

构建与运行

典型的构建流程非常常规：

$ cd <avp-source-code>
$ mkdir build
$ cd build
$ cmake ..
$ make

顺利的话会产出名为 avp 的可执行文件。前提是系统已安装 CMake、SDL3、OpenAL、OpenGL 以及上述 FFmpeg 开发库。

运行方面，游戏数据是必需的，合法获取途径包括 GOG、Steam 上的《Aliens versus Predator Classic 2000》，或原版 CD 安装介质。数据准备有两条硬性要求：

1. 所有游戏数据、文件与目录名必须改成小写，否则引擎无法定位资源。
2. 要么把 avp 可执行文件复制到游戏数据目录中，要么通过 AVP_DATA 环境变量指向数据目录。

平台相关的数据目录约定为：macOS 使用 /Users/$USER/Library/Application Support/AliensVsPredator/；GNU/Linux 及其他 *NIX / BSD 使用 /usr/local/games/AliensVsPredator。本地用户设置则单独保存在 ~/.avp。