# estella (esengine/estella)

> A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

- GitHub: https://github.com/esengine/estella
- GitHub.Locker page: https://github.locker/esengine/estella
- Stars: 1.2K
- Language: TypeScript
- License: Apache-2.0
- Last push: 2026-11-18

---

## README (checked against GitHub 2026-11-19)

Source: https://github.com/esengine/estella/blob/master/README.md

<div align="center">

<img src=".github/logo.png" width="120" alt="Estella logo" />

# Estella

**A 2D and 3D game engine whose editor is an MCP server.**<br/>
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](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![Release](https://img.shields.io/github/v/release/esengine/estella)](https://github.com/esengine/estella/releases)
[![MCP](https://img.shields.io/badge/MCP-167_tools-8A2BE2.svg)](https://estellaengine.com/docs/agents/mcp/)
[![Platform](https://img.shields.io/badge/Platform-Web%20%7C%20Mini--games%20%7C%20Playable%20ads%20%7C%20Desktop%20%7C%20Android%20%7C%20iOS-green.svg)](https://estellaengine.com/docs/publishing/overview/)
[![Ask DeepWiki](https://img.shields.io/badge/Ask-DeepWiki-1f6feb.svg)](https://deepwiki.com/esengine/estella)

<img src="docs/assets/icons/globe.svg" width="18" height="18" align="absmiddle" alt="" /> [Website](https://estellaengine.com) &nbsp;·&nbsp; <img src="docs/assets/icons/bot.svg" width="18" height="18" align="absmiddle" alt="" /> [Agent](#your-agent-drives-the-editor) &nbsp;·&nbsp; <img src="docs/assets/icons/rocket.svg" width="18" height="18" align="absmiddle" alt="" /> [Getting Started](#getting-started) &nbsp;·&nbsp; <img src="docs/assets/icons/book-open.svg" width="18" height="18" align="absmiddle" alt="" /> [Documentation](#documentation) &nbsp;·&nbsp; <img src="docs/assets/icons/message-circle.svg" width="18" height="18" align="absmiddle" alt="" /> [QQ群 481923584](https://qm.qq.com/q/BONa5LXQ0U)

<br/>

<img src="docs/assets/agent-e58817d7.webp" alt="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" width="900" />

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

</div>

<a id="your-agent-drives-the-editor"></a>

## <img src="docs/assets/icons/bot.svg" width="26" height="26" align="absmiddle" alt="" /> 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:

- <img src="docs/assets/icons/hammer.svg" width="20" height="20" align="absmiddle" alt="" /> **It builds** — creates projects, spawns entities from the editor's own Create catalog,
  writes component fields, makes prefabs, paints tilemaps, writes and type-checks scripts.
- <img src="docs/assets/icons/eye.svg" width="20" height="20" align="absmiddle" alt="" /> **It looks** — takes screenshots of the viewport and the running game, replays a frame
  draw by draw, compares the game with reference images, and audits what a scene's look lacks.
- <img src="docs/assets/icons/play.svg" width="20" height="20" align="absmiddle" alt="" /> **It plays** — enters Play mode, steps time deterministically, sends input and clicks
  UI by name, runs scripted playtests, then reads the running world back.
- <img src="docs/assets/icons/palette.svg" width="20" height="20" align="absmiddle" alt="" /> **It makes assets** — images, sound effects, music and 3D models, each answered with
  a picture of what it made.
- <img src="docs/assets/icons/rocket.svg" width="20" height="20" align="absmiddle" alt="" /> **It ships** — reads project health, exports the game, and drives a build running on a
  connected phone.

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](https://estellaengine.com/docs/agents/mcp/)

## <img src="docs/assets/icons/shield-check.svg" width="26" height="26" align="absmiddle" alt="" /> 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.

- <img src="docs/assets/icons/plug.svg" width="20" height="20" align="absmiddle" alt="" /> **The protocol is the editor, not a plugin on it.** The 167 tools call the pipelines the
  editor's own menus, inspector and toolbar run, so an agent's edit is the edit a person
  would have made, and undoes the same way. Calls are schema-checked and permission-gated
  by the editor itself.
- <img src="docs/assets/icons/eye.svg" width="20" height="20" align="absmiddle" alt="" /> **The agent can check its own work.** It steps a paused game frame by frame, so
  "play three seconds, then look" is the same frame every run. It sees the game, not just the
  log: screenshots, a frame replayed draw call by draw call, the game set beside a reference
  image, scripted playtests that read the running world back.
- <img src="docs/assets/icons/wand-sparkles.svg" width="20" height="20" align="absmiddle" alt="" /> **The agent can make what the game needs.** Sprites, textures, sound effects, music and
  3D models come from tools inside the editor, so a prototype does not stop at grey boxes
  while someone opens five other programs.
- <img src="docs/assets/icons/file-text.svg" width="20" height="20" align="absmiddle" alt="" /> **Everything is text.** Scenes, prefabs and materials are JSON; gameplay is TypeScript.
  An agent reads and writes the project directly, and every change is a reviewable diff.
- <img src="docs/assets/icons/globe.svg" width="20" height="20" align="absmiddle" alt="" /> **It ships where heavier engines struggle.** A WebAssembly runtime that loads on a phone
  browser, seven Chinese mini-game platforms, single-file playable ads for the major ad
  networks, and native Android / iOS apps — from one project.
- <img src="docs/assets/icons/scale.svg" width="20" height="20" align="absmiddle" alt="" /> **It is open.** The runtime, SDK, pipeline and CLI are Apache-2.0: no royalties, no seats,
  no runtime fees. The editor is a free download.

## <img src="docs/assets/icons/camera.svg" width="26" height="26" align="absmiddle" alt="" /> Rendered in real time

<div align="center">
  <img src="docs/assets/day-1ea1637f.webp" alt="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" width="900" />
  <br/>
  <sub><i>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, <a href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>, modified.</i></sub>
</div>

<div align="center">
  <a href="https://github.com/esengine/estella-space-frigate"><img src="docs/assets/space-frigate-efc7716b.webp" alt="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" width="900" /></a>
  <br/>
  <sub><i><a href="https://github.com/esengine/estella-space-frigate">Space Frigate</a>, 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.</i></sub>
</div>

## <img src="docs/assets/icons/layers.svg" width="26" height="26" align="absmiddle" alt="" /> 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.

<img src="docs/assets/icons/layers.svg" width="20" height="20" align="absmiddle" alt="" /> **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.

<img src="docs/assets/icons/box.svg" width="20" height="20" align="absmiddle" alt="" /> **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.

<img src="docs/assets/icons/globe.svg" width="20" height="20" align="absmiddle" alt="" /> **Everywhere** — one renderer for 2D and 3D on WebGL 2 and WebGPU, and one project
exports to:

| Target | What you get |
|---|---|
| <img src="docs/assets/icons/globe.svg" width="20" height="20" align="absmiddle" alt="" /> Web | a static, self-contained build |
| <img src="docs/assets/icons/gamepad-2.svg" width="20" height="20" align="absmiddle" alt="" /> Mini-games | WeChat, Douyin, Kuaishou, Bilibili, Alipay, Huawei and quick games |
| <img src="docs/assets/icons/megaphone.svg" width="20" height="20" align="absmiddle" alt="" /> Playable ads | one inlined `index.html` for Meta, Google, Unity, AppLovin, Mintegral, TikTok / Pangle and MRAID networks |
| <img src="docs/assets/icons/monitor.svg" width="20" height="20" align="absmiddle" alt="" /> Desktop | a native app on Windows, macOS and Linux — no Chromium |
| <img src="docs/assets/icons/smartphone.svg" width="20" height="20" align="absmiddle" alt="" /> Android / iOS | a native arm64 app on Vulkan / Metal — not a WebView |

<a id="getting-started"></a>

## <img src="docs/assets/icons/rocket.svg" width="26" height="26" align="absmiddle" alt="" /> Getting Started

<img src="docs/assets/icons/download.svg" width="20" height="20" align="absmiddle" alt="" /> **Install.** Download the editor for Windows or macOS from
[estellaengine.com](https://estellaengine.com/#download) — always the newest release.
Every build is also on the [releases page](https://github.com/esengine/estella/releases).

<img src="docs/assets/icons/folder-plus.svg" width="20" height="20" align="absmiddle" alt="" /> **Create a project.** Open the editor, click **New Project**, pick a template.

<img src="docs/assets/icons/code.svg" width="20" height="20" align="absmiddle" alt="" /> **Write a system.**

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

<img src="docs/assets/icons/play.svg" width="20" height="20" align="absmiddle" alt="" /> Press **F5** to play — or connect your agent and ask it to do all three.

<a id="documentation"></a>

## <img src="docs/assets/icons/book-open.svg" width="26" height="26" align="absmiddle" alt="" /> Documentation

Everything lives at [estellaengine.com/docs](https://estellaengine.com/docs).

| | Start here | What it covers |
|---|---|---|
| <img src="docs/assets/icons/rocket.svg" width="20" height="20" align="absmiddle" alt="" /> | [Quick Start](https://estellaengine.com/docs/getting-started/quick-start/) | install the editor, make a project, press play |
| <img src="docs/assets/icons/boxes.svg" width="20" height="20" align="absmiddle" alt="" /> | [ECS](https://estellaengine.com/docs/core-concepts/ecs/) | components, systems and queries — how game logic is written |
| <img src="docs/assets/icons/bot.svg" width="20" height="20" align="absmiddle" alt="" /> | [AI Agents](https://estellaengine.com/docs/agents/mcp/) | connect Claude Code, Cursor or Codex to the editor |
| <img src="docs/assets/icons/sun.svg" width="20" height="20" align="absmiddle" alt="" /> | [Time of Day](https://estellaengine.com/docs/graphics/time-of-day/) | a sun and sky that follow the clock |
| <img src="docs/assets/icons/cloud-rain.svg" width="20" height="20" align="absmiddle" alt="" /> | [Weather](https://estellaengine.com/docs/graphics/weather/) | mist, rain and snow |
| <img src="docs/assets/icons/package.svg" width="20" height="20" align="absmiddle" alt="" /> | [Exporting](https://estellaengine.com/docs/publishing/overview/) | web, desktop, playable ads and the rest, from one project |
| <img src="docs/assets/icons/gamepad-2.svg" width="20" height="20" align="absmiddle" alt="" /> | [Mini-game platforms](https://estellaengine.com/docs/publishing/minigame-platforms/) | WeChat, Douyin, Kuaishou, Bilibili, Alipay, Huawei |
| <img src="docs/assets/icons/smartphone.svg" width="20" height="20" align="absmiddle" alt="" /> | [Android & iOS](https://estellaengine.com/docs/publishing/android-ios/) | native arm64 apps |

## <img src="docs/assets/icons/message-circle.svg" width="26" height="26" align="absmiddle" alt="" /> Feedback

Estella does not accept pull requests. Bug reports and feature requests are welcome as
[issues](https://github.com/esengine/estella/issues) — see [CONTRIBUTING.md](CONTRIBUTING.md)
for what to include, and for building the engine from source.

Maintainers: see the [release procedure](RELEASING.md) for candidate builds, acceptance evidence and publishing.

## <img src="docs/assets/icons/scale.svg" width="26" height="26" align="absmiddle" alt="" /> 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](LICENSE) — free
for any purpose, commercial use included. We follow [Semantic Versioning](VERSIONING.md)
and keep a [CHANGELOG](CHANGELOG.md).

- **The visual editor** is a separate, free product built on this engine; its source is
  not public. Everything needed to build, run and ship a game is here — see
  [BUSINESS_MODEL.md](BUSINESS_MODEL.md).
- **Trademarks.** The license covers the code, not the "Estella" / "ESEngine" names or
  logos: say your project uses Estella, but don't ship a fork under that name.
- **Spine.** The bundled [Spine Runtimes](third_party) are not open source; a game that
  uses Estella's Spine integration needs its own Spine license. See [NOTICE](NOTICE).

