OpenNefia：可模组化的《Elona》类 roguelike 引擎重实现（C#）

Widelands 是一款体量相当大的自由软件即时战略游戏，玩家需要在一片未开发的地图上从零建立起自己的定居点：砍伐木材、开采矿石、铺设道路、修建仓库与生产线，把原材料一层层加工成工具、武器与食物，再以此支撑人口增长和领土扩张。与许多强调快节奏对抗的 RTS 不同，它的节奏更接近“经济先行”的建造类玩法，运输与物流效率往往比单纯的兵力堆叠更关键。游戏同时提供单人战役与多人对战两种主要模式，单人部分围绕剧情任务逐步引导玩家理解各系统的运作方式，多人部分则用于玩家之间的对抗或合作。

从内容组织上看，本仓库把游戏本体与素材放在 data 目录中，其中包含图像、音效、音乐、脚本、地图、战役与不同部落（tribes）的定义，这意味着玩家看到的文明差异、建筑树与生产链在很大程度上是数据驱动的，而非全部硬编码在程序里。剧本与任务逻辑通过脚本语言编写，官方文档站点提供了专门的脚本接口索引，鼓励社区自制地图与战役。项目的路线明确表示灵感来自《工人物语II》，但自称在多样性与深度上有明显扩展——这一点从其复杂的分级生产链与多部落设定中可以看出。

核心特性

技术层面，Widelands 使用 C++ 编写，并采用自研引擎而非现成的商业引擎或通用游戏框架：渲染依赖 SDL2 与 OpenGL 相关库（GLEW 或可选的 glbinding），窗口与输入、字体、音频分别由 SDL、SDL_ttf、SDL_mixer 承担，压缩与图像处理使用 zlib 与 libpng，网络通信基于 Asio，国际化通过 gettext 完成。脚本层使用 Lua，仓库中还有用 Python 编写的构建、翻译与打包辅助工具。构建系统以 CMake 为核心，同时提供 compile.sh 便捷脚本，可按需生成 Debug 或 Release（含带调试符号的 Release）版本；CMake 选项中暴露了 AddressSanitizer、ThreadSanitizer、单元测试、代码检查、网站工具、静态链接 Windows 可执行文件、遵循 XDG 目录规范等开关，make/ninja 还提供 codecheck、doc（Doxygen 文档）与 install 等目标。代码风格遵循 Google C++ Styleguide，主分支与议题、拉取请求在 Codeberg 与 GitHub 之间由机器人双向镜像并自动格式化 C++、Lua 与 Python 代码。

平台方面，官方声明支持在 Linux、Windows（MSys2 或 MSVC 工具链）以及 macOS 上编译，推荐使用 GCC 8 及以上或 Clang/LLVM 7 及以上；仓库提供 install-dependencies.sh 自动识别系统并安装依赖（也可显式指定如 debian），编译完成后直接运行生成的可执行文件即可。下载渠道指向官网的下载页面，文档站另有详尽的构建说明、图形素材贡献指南、翻译流程与测试分支说明。许可方面，代码采用 GPLv2+，部分美术与音频素材使用不同的 Creative Commons 许可，具体需查看各素材目录中的说明文件。

技术要点

值得一提的是，项目在贡献指南中明确写入了一条针对 AI 生成内容的政策：不接受全部或主要由人工智能、机器学习或大语言模型生成的内容，理由是版权与素材来源的伦理问题，以及此类内容往往过于通用、难以贴合项目自身需求；由 AI 生成的拉取请求可能被直接关闭。对于希望参与开源的人来说，这是一条需要提前了解的协作约定。

从学习角度看，这个仓库适合研究几个方向：一是大型 C++ 项目的目录划分与模块边界（cmake 构建规则与代码检查、src 源码、data 数据、test 回归测试地图、utils 工具链、xdg 规范相关文件各自独立）；二是自研引擎如何借助 SDL 与 OpenGL 封装渲染、音频、输入与网络；三是脚本驱动的内容系统如何把地图与战役从程序逻辑中剥离；四是跨平台持续集成与自动化代码格式化的工程实践。需要注意的是，依赖库数量较多、完整构建耗时较长，首次编译建议使用官方脚本并预留磁盘与内存；仓库体积与素材规模也不小，浅克隆会更友好。此外，游戏的界面中文化与本地化依赖翻译进度，具体语言完成度需以官方发布版本为准。