esengine/estella
游戏用 TypeScript 编写游戏逻辑、以 MCP 驱动编辑器的 2D/3D 引擎,一套项目可导出到 Web、小游戏、试玩广告和桌面/移动端。
项目介绍
Estella 是一个 2D/3D 游戏引擎,核心用 C++ 编写并以 WebAssembly 运行,游戏逻辑通过 TypeScript SDK 以 ECS 系统编写。场景、预制体和材质保存为 JSON,因此整个项目都是可阅读、可对比的文本。它面向需要一套项目同时发布到 Web、微信等小游戏平台、试玩广告、桌面端以及原生 Android/iOS 的开发者。2D 部分包括精灵与动画、支持 LDtk 导入的瓦片地图、Spine 与 DragonBones、2D 光照、Box2D 物理和 UI;3D 部分包括 glTF/FBX 导入、PBR 材质、带阴影的光源、昼夜与天气、烘焙光照贴图、SSR/SSGI、地形、水面、植被和骨骼动画。
它最特别的地方是编辑器本身作为 MCP 服务器。连接 Claude Code、Cursor 或 Codex 等 MCP 客户端后,代理可以调用 167 个工具,这些工具走的是编辑器界面同一套管线:创建实体、修改组件、截图、逐帧推进运行中的游戏、生成精灵和音效、执行导出。编辑器初始为只读,用户在 Window → Connect AI Tools… 中授权后代理才能修改项目,该操作还会顺带写入客户端的 MCP 配置。代理的每次调用都是一步可撤销操作,用户可以随时接管鼠标。
快速上手
- 从官方下载页下载 Windows 或 macOS 编辑器;同一批构建也会列在发布页上。
- 打开编辑器,点击 New Project,选择一个模板。
- 添加 TypeScript 系统,例如下面这个按
Time.delta移动实体的组件和系统:
import {
defineComponent, defineSystem, addSystem,
Query, Mut, Res, Time, LocalTransform
} from 'esengine';
const Speed = defineComponent('Speed', { value: 200 });
addSystem(defineSystem(
[Res(Time), Query(Mut(LocalTransform), Speed)],
(time, query) => {
for (const [entity, transform, speed] of query) {
transform.position.x += speed.value * time.delta;
}
}
));
- 按 F5 运行,或连接 MCP 客户端让代理完成这些步骤。Quick Start 和 ECS 文档介绍了安装、创建项目以及组件、系统和查询的用法。
导出流程见发布概览;小游戏目标见小游戏平台文档,原生构建见 Android 与 iOS 文档。
使用约束
本仓库公开的是运行时、SDK、资源管线、CLI、模板和编辑器插件 API,采用 Apache-2.0 许可;可视化编辑器是另一款免费但闭源的产品,使用编辑器工作流需要下载桌面程序。仓库不接受 pull request,问题反馈和功能请求请走 issues,从源码构建的说明在 CONTRIBUTING.md。内置的 Spine 运行时不是开源软件,使用 Estella 的 Spine 集成需要自行持有 Spine 许可证。许可证也不包含 Estella/ESEngine 名称和 Logo,因此分支项目不能以此名称发布。
HotRepo 点评
在 2026-11-16 的 TypeScript 日榜上,Estella 记录到 37 个新增 Star,最好名次为第 11,当期快照为 931 Star、164 Fork。这说明项目仍在上升阶段,最亮眼的一次记录出现在语言榜,目前没有全语言日榜名次记录。更值得关注的是“编辑器即 MCP 服务器”的设计:代理操作被绑定到编辑器自身的命令面和撤销栈上,这给代理如何改动项目设定了具体边界,而不只是另开一套脚本接口。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。