Estella 2D/3D 游戏引擎（TypeScript + C++/WebAssembly）

代码现状

README 的「Code」一节给出了最关键的提示：

• 最后一个可工作的版本保存在 contrib/old-codebase 分支目录中。
• 当前主线（develop）是重写中的新代码，并不等同于可直接游玩的成品。

因此，如果你只是想编译并跑起来看看效果，应优先查看 contrib/old-codebase；如果你想了解项目的新架构方向，则关注重写后的代码。

为什么做这个项目

「Why?」一节说明了项目动机：作者希望开发一个开源、100% 可模组化的方块游戏，并且能运行在任何 Mono 支持的平台上。README 同时坦承项目离完成还很远，并明确欢迎贡献者加入。

这里的“可模组化”是项目目标而非已完成的承诺，README 没有展开具体的模组 API 或插件机制细节，读者不应据此推断已有成熟的模组系统。

重写与取舍

「Retake?」一节是理解项目现状的关键：

• 项目最初以 hack & slash 的方式起步，规模在无意中膨胀。
• 旧代码可维护性较差，并且存在 bug，README 特别提到著名的“meshing bug”（网格构建问题）。
• 团队决定从头重写，要求新代码带有清晰的注释，并为所有主要功能编写测试。
• 新版本放弃对 XNA 的支持，只使用 MonoGame，原因是同时维护所有平台相当困难。
• 旧代码保留在 contrib/old-codebase 中。

这段说明也解释了为什么仓库同时存在“旧的可运行版本”和“重写中的新版本”两种状态。

参与前先读文档

「Stay awhile and listen」一节提醒参与者：在提问之前，先阅读 FAQ 与 wiki。README 中给出的链接指向 raistlinthewiz 名下的 wiki 页面。对于想上手或想贡献的开发者，这是了解项目约定与常见问题的入口。

截图

README 末尾附有两张来自 indiedb 的客户端截图（文件名带有 2012 年的时间戳），可用于直观了解旧版本客户端的画面风格。截图仅作展示，不代表当前重写版本的画面。

学习建议

这个项目更适合作为“体素引擎实现”与“项目重写取舍”的阅读材料：

• 可以对比 contrib/old-codebase 与重写代码，观察作者如何重构与补测试。
• 关注 README 提到的 meshing 问题，理解体素渲染中网格构建的难点。
• 注意项目从 XNA 迁移到 MonoGame 的原因，对跨平台 C# 游戏开发有参考价值。

由于项目尚未完成，不建议把它当作开箱即用的完整游戏来评估。