Overgrowth（开源 3D 近战动作游戏源码）

《Dungeon Crawl Stone Soup》在开源 roguelike 社区中通常简称 Crawl。它的官方仓库并非只存放演示代码的样板，而是持续维护的完整游戏工程：玩法逻辑、地图与怪物数据、图块资源、手册和构建脚本都在其中。项目血缘可追溯到 Linley's Dungeon Crawl，Brent Ross 在 2005 年发布该系列最后一个 alpha（v4.1），2006 年起 Stone Soup 团队接手并延续开发。仓库以 GPLv2+ 授权，CREDITS.txt 记录贡献者名单。这段历史决定了它既有传统地牢爬行的硬核气质，也积累了近二十年社区协作形成的设计惯例。

玩法围绕地牢探索、战斗与魔法展开。角色拥有不同技能组合，并可崇拜能力强大、性格反复无常的神祇；README 明确说取胜需要成为战术与策略大师，并在压倒性劣势中取胜。游戏内提供教程选项、quickstart.md、完整手册 crawl_manual.rst，以及通过 ?Q 打开的常见问题列表，降低入门门槛。在线模式允许与其他玩家竞争或观战，可通过浏览器 webtiles 或 SSH 连接最近服务器；离线模式同时提供经典 ASCII 与 tiles（GUI）两种呈现，面向 Linux、Windows 和 OS X 下载。

核心特性

仓库的一大特点是内容制作高度数据驱动。关卡并非单一算法从零生成，而是把大量手工设计、常带随机化元素的 vault 组合起来；README 建议新手从 simple.des 的 entry vault 示例入手，并阅读关卡设计手册。怪物语音与物品描述同样以数据条目扩充：语音语法有效但不太常规，需参考 monster_speech.txt；物品描述可在游戏内用 ?/ 查看，源文件位于 dat/descript/，撰写时要求带风味文本、提示主要强弱项、尽量不写数字，引用也应避免最泛用的桥段。图块美术也欢迎改进和变体提交。这种分工让不写 C++ 的人也能通过地图、文本和美术参与。

技术实现方面，主体以 C++ 编写，同时使用 Lua 脚本语言承载游戏内功能与用户宏；正则表达式由 PCRE 处理，SQLite 作为数据库引擎，SDL 与 SDL_image 负责 tiles 显示，libpng 负责图块图像加载。README 顶部用 GitHub Actions 的 Build 徽章展示构建状态，说明项目有持续集成。参与代码贡献前，文档要求先阅读 coding_conventions.md；大型改动应先与开发团队沟通，确认是否已有计划、建议是否可能被接受。缺陷通过 GitHub issue tracker 报告，补丁、地图、图块等可通过 pull request 提交。贡献者指南还描述完整的 crawl workflow。

技术要点

获取方式上，安装说明位于 crawl-ref/INSTALL.md；官方主页 crawl.develz.org 汇总在线 webtiles、离线下载、社区论坛 tavern.dcss.io，以及 Discord、/r/dcss subreddit 和 Libera IRC 的 #crawl、#crawl-dev 频道。离线下载页明确列出 Linux、Windows、OS X 版本，且 ASCII 与 tiles 两种版本并存；在线游玩可在浏览器或 SSH 中进行。国内环境方面，README 没有提供国内镜像或加速方案，源码构建需按 INSTALL.md 准备 C++ 工具链及 SDL、SDL_image、libpng、PCRE、SQLite、Lua 等依赖，具体版本与包名待核验；在线服务器多位于海外，连接质量可能受网络影响。

对学习者而言，这个仓库适合观察大型 C++ 游戏如何把核心规则、脚本、数据文件和跨平台显示层拆开，也适合研究传统 roguelike 的关卡组合、物品与怪物文本体系以及长期开源项目的协作流程。由于代码库历史长、体量大，初学者不宜一上来就改核心战斗逻辑；更稳妥的路径是先读 quickstart 与手册理解玩法，再从 vault、物品描述、怪物语音或图块等低风险内容切入，最后按贡献者指南提交。需要注意，README 主要面向玩家与贡献者，并未给出完整架构教程；若要把项目当作课程案例，应结合源码与文档自行梳理模块边界，避免把社区经验当成官方说明。