Frogatto & Friends（青蛙主角 2D 横版动作冒险游戏）

这个仓库是 id Software 面向社区放出的《Quake 2》3.19 版完整源代码，发布说明由 John Carmack 署名，并特别感谢 Robert Duffy 完成整理与构建工作。它不是一个开箱即玩的游戏发行包，而是当年商业第一人称射击游戏的工程源码归档：仓库中没有原版关卡、模型、贴图、音效等游戏数据，因此仅克隆代码并不能直接得到可运行的《Quake 2》。它的核心价值在于把一款完整 FPS 的客户端、服务端与玩法逻辑摊开给开发者阅读，同时也为基于 GPL 的独立游戏、总转换模组以及引擎移植提供代码和法律基础。

授权部分是理解这个仓库的关键。README 明确说明全部代码按 GPL 发布，读者可以自由使用、修改，甚至销售自己制作的新版本；但代价是，一旦分发新的二进制版本，就必须免费向所有人提供完整源代码。发布者的主要意图是娱乐与教育，不过 GPL 同样允许在遵守完整许可证的前提下进行商业开发。如果商业项目无法接受公开源码，发布说明还提到可以另行协商单独的授权协议，但总体上鼓励直接遵循 GPL。需要注意的是，这种“可商用”针对的是代码，而不是原版游戏资产。

核心特性

数据文件的版权边界也必须分清。所有《Quake 2》原始数据文件仍按原条款保留版权，不能被重新分发；因此不能把仓库代码和原版素材打包成新的游戏发行。README 给出的合法路径是进行真正的“完全转换”（total conversion）：如果制作者替换掉全部受版权保护的内容，就可以基于这套代码构建独立游戏。这一点对想做 Quake 风格 FPS 的团队尤其重要，因为它把“引擎代码可用”和“原作素材不可用”区分得很清楚。

从技术学习角度看，这是一份用 C 语言写成的完整商业 FPS 源码，规模与复杂度都远超教学示例。代码覆盖第一人称射击游戏常见的多个子系统，包括玩家控制与输入、碰撞检测与物理响应、敌人 AI、关卡与游戏状态管理、渲染、音频以及网络联机等。读者可以观察早期 id Software 引擎如何组织客户端与服务端、如何处理多人对战中的状态同步、如何把渲染、碰撞和游戏逻辑分层。由于它是实际发行过的商业代码，而不是为教学重写的简化框架，里面既有值得借鉴的工程取舍，也有历史包袱和平台相关代码，适合带着问题去读，而不适合从头到尾线性通读。

技术要点

构建方面，README 给出的官方路径是使用 Visual C++ 6.0 构建 Windows 版本；Linux 版本“应当可以构建”，但发布前没有经过测试。这意味着仓库没有承诺现代编译器、现代操作系统或现代依赖管理下的开箱即用体验。README 也没有提供完整的依赖清单、CMake 工程或一键构建脚本，想要在当代环境编译，通常需要自行评估旧工具链、32 位兼容性、图形与音频依赖以及平台 API 差异。仓库同样不包含原版数据，所以即使编译成功，也需要合法的数据文件或自制总转换内容才能进入游戏。

这个项目更适合作为高级向的源码研究材料，而不是初学者的第一个游戏项目。它的学习价值在于理解一款完整 FPS 如何把渲染、网络、碰撞、AI、音频和游戏状态整合成一个可运行系统，也适合研究 GPL 代码如何用于商业发行、总转换和独立游戏。使用前应明确：代码可商用但衍生二进制必须公开源码；原版数据不可随代码分发；官方仅说明了 VC++ 6.0 构建路径，Linux 构建未经发布测试。国内构建还需注意旧版 MSVC 工具链获取困难、Linux 依赖和 32 位兼容性待核验，以及原版数据文件的版权合规问题。