estella README

项目的 README,来自 github.com/esengine/estella。合并为一个 markdown 文件:README.md。

Estella logo

Estella

A 2D and 3D game engine whose editor is an MCP server.
Your AI agent builds the game with the same 167 tools the editor's own UI uses — then ships it to the web, mini-game platforms, playable ads, desktop and native mobile.

License: Apache 2.0 Release MCP Platform Ask DeepWiki

Website  ·  Agent  ·  Getting Started  ·  Documentation  ·  QQ群 481923584


An AI agent driving the Estella editor over MCP: it opens the Bistro project, finds the Weather entity and turns it to snow, sets the time of day to 9 pm, presses Play, steps the game and takes a screenshot of the snowy night it made

Every frame is one MCP tool call into the editor, captured as it happened — no mouse involved.

Your agent drives the editor

The Estella editor speaks the Model Context Protocol. Connect Claude Code, Cursor, Codex or any MCP client, and the agent works inside the real editor rather than around it:

Every call goes through the editor's command surface: each one is one undo step, you watch it happen in the window, and you can take the mouse back at any time. The editor starts read-only; an agent edits only after you allow it in Window → Connect AI Tools…, which also writes the client's MCP config for you.

Group What the agent gets
core scene tree, entities, components, play / step / input, screenshots, logs, undo
assets · prefab · authoring asset documents and import settings, tilemaps, prefabs and variants, physics bodies, UI events
look · render reference images beside the game, light and field sweeps, frame capture and replay, shadows, LOD, bakes
code · project scripts, symbol search, type-check, project settings, health, export
image · sound · modeling draw sprites and textures, compose sound and music, build 3D models from steps
play · view · device gamepads, time scale, scripted playtests, editor view, and a game running on a connected phone

→ Connecting an agent

Why Estella, when Unity and Unreal have MCP too?

An MCP server can be bolted onto any editor. What an agent can actually get done depends on what sits behind it.

Rendered in real time

The Bistro street corner rendered in real time by Estella from morning to night: a low sun, mist, rain that leaves puddles with rings on the water and splashes on the street, then snow settling on the awnings and falling past the lit street lamps
One day on the Amazon Lumberyard Bistro, recorded frame by frame from the running game: a sun that follows the clock, weather that turns from clear to mist, rain and snow, baked bounce light, reflections and volumetric haze. Scene © Amazon Lumberyard, CC BY 4.0, modified.
Space Frigate, a game made with Estella: a frigate cruises off a gas giant, turns on her thrusters, fires her turrets at an asteroid, then flies through a gate, down a tunnel of light, and comes out beside a ringed ice giant
Space Frigate, a game made with Estella and recorded frame by frame as it runs: flying on thrusters, gunnery, and a jump through a gate to another star system. Every model, texture and sound in it is generated from a recipe.

What's inside

Estella is a C++ engine with a TypeScript SDK. The core runs as WebAssembly on the web and natively on desktop and mobile; game logic is written as ECS systems in TypeScript.

2D — sprites and sprite animation, tilemaps (with LDtk import), Spine 2.1 – 4.3 and DragonBones, 2D lights and shadows, UI with layout, rich and bitmap text, particles, Box2D physics, native 2D rigs.

3D — glTF / FBX import, PBR materials, directional / point / spot lights with shadows, sky atmosphere with time of day and weather, baked lightmaps, light and reflection probes, SSR, SSGI, height fog, terrain, water, foliage, skeletal animation with spring bones, navigation, Jolt or PhysX physics, streamed large worlds.

Everywhere — one renderer for 2D and 3D on WebGL 2 and WebGPU, and one project exports to:

Target What you get
Web a static, self-contained build
Mini-games WeChat, Douyin, Kuaishou, Bilibili, Alipay, Huawei and quick games
Playable ads one inlined index.html for Meta, Google, Unity, AppLovin, Mintegral, TikTok / Pangle and MRAID networks
Desktop a native app on Windows, macOS and Linux — no Chromium
Android / iOS a native arm64 app on Vulkan / Metal — not a WebView

Getting Started

Install. Download the editor for Windows or macOS from estellaengine.com — always the newest release. Every build is also on the releases page.

Create a project. Open the editor, click New Project, pick a template.

Write a system.

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;
        }
    }
));

Press F5 to play — or connect your agent and ask it to do all three.

Documentation

Everything lives at estellaengine.com/docs.

Start here What it covers
Quick Start install the editor, make a project, press play
ECS components, systems and queries — how game logic is written
AI Agents connect Claude Code, Cursor or Codex to the editor
Time of Day a sun and sky that follow the clock
Weather mist, rain and snow
Exporting web, desktop, playable ads and the rest, from one project
Mini-game platforms WeChat, Douyin, Kuaishou, Bilibili, Alipay, Huawei
Android & iOS native arm64 apps

Feedback

Estella does not accept pull requests. Bug reports and feature requests are welcome as issues — see CONTRIBUTING.md for what to include, and for building the engine from source.

Maintainers: see the release procedure for candidate builds, acceptance evidence and publishing.

License

The engine runtime, SDK, asset pipeline, CLI, project templates and editor plugin API in this repository are licensed under the Apache License, Version 2.0 — free for any purpose, commercial use included. We follow Semantic Versioning and keep a CHANGELOG.

estella (esengine/estella)

正在搜索数据库…

1.2K ·GitHub
这是什么?这是一个 2D 和 3D 游戏引擎,核心用 C++/WebAssembly 编写,SDK 使用 TypeScript。它的可视化编辑器同时也是一个 MCP 服务器,因此 Claude Code、Cursor 等 AI 智能体可以使用编辑器自身界面所用的同一套工具来制作游戏。
它是框架还是完整的编辑器?两者都是。游戏逻辑用 TypeScript 编写,以引擎之上的 ECS 系统实现;可视化编辑器则是单独的免费下载,支持 Windows 和 macOS。
怎么让它跑起来?从 estellaengine.com 下载适用于 Windows 或 macOS 的编辑器,打开后点击“New Project”,选择一个模板,然后按 F5 开始游戏。
哪些 AI 工具可以操作编辑器?Claude Code、Cursor、Codex 或任何 MCP 客户端都可以。编辑器启动时为只读状态,你需要在“Window → Connect AI Tools”中允许某个智能体访问,此操作还会写入该客户端的 MCP 配置。
做好的游戏能在哪里运行?同一个项目可以导出到网页、微信及其他小游戏平台,导出为单文件可试玩广告,也可以打包为 Windows、macOS 和 Linux 上的原生桌面应用,以及原生 arm64 架构的 Android 和 iOS 应用。
授权方面有什么需要注意的吗?引擎运行时、SDK、流水线和 CLI 采用 Apache-2.0 协议,但可视化编辑器的源代码并未公开。随附的 Spine 运行时不是开源的,因此使用 Spine 的游戏需要自己的 Spine 授权。
为什么要用它,而不是配合 MCP 使用 Unity 或 Unreal?智能体的修改会经过编辑器自身的流水线,因此每次改动都是一个普通的、可撤销的步骤;场景和游戏逻辑则是纯 JSON 与 TypeScript。同一个项目还能通过 WebAssembly 运行时导出为小游戏和可试玩广告。
智能体能检查自己的工作吗?可以。它能让暂停的游戏逐帧推进,截取屏幕截图,按绘制调用逐一回放某一帧,并运行脚本化的试玩测试,读取正在运行的世界状态。
它能渲染和模拟哪些内容?2D 精灵、Spine、DragonBones、瓦片地图和 Box2D;3D 方面则支持 PBR 材质、glTF 和 FBX 导入、阴影、烘焙光照贴图、地形、水体,以及 Jolt 或 PhysX 物理引擎,基于 WebGL 2 和 WebGPU 运行。
作者
esengine
大小
1.2 GB
星标
1.2K
时长
9个月
提交 · 90 天