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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
docs: describe Estella as a 2D and 3D engine
yhh6f783e1070fb
diff --git a/AGENTS.md b/AGENTS.mdindex 977fa0d54..d26f6fe96 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -1,11 +1,11 @@# Project priorities-- The product focus is 2D. Prioritize 2D authoring, UI, sprites and animation,- tilemaps, input, audio, and reliable Web / minigame delivery when choosing- roadmap work and ordering cards.-- Schedule specialized 3D rendering, large-world features, and character tools- after the 2D production workflow. Shared fixes that also benefit 2D remain- eligible for early work.+- 2D and 3D are equally important product directions. Weigh 2D authoring, UI,+ sprites and animation, tilemaps, input, audio and reliable Web / minigame+ delivery together with 3D rendering, lighting, large-world features and+ character tools when choosing roadmap work and ordering cards. Do not defer+ 3D behind 2D. Public descriptions (README, docs, repository summary) name+ both.- Review actual PR merge status and verification evidence before updatingroadmap completion. A merged PR alone does not prove device acceptance.- Do not add generated-by attribution or assistant co-author trailers todiff --git a/README.md b/README.mdindex 01a5ace6e..c1fbab99f 100644--- a/README.md+++ b/README.md@@ -4,7 +4,7 @@# Estella-**A fast 2D/3D game engine powered by WebAssembly and ECS**+**A fast 2D and 3D game engine powered by WebAssembly and ECS**[](https://github.com/esengine/estella/actions/workflows/build.yml)[](LICENSE)@@ -21,7 +21,7 @@## What is Estella?-Estella is a **2D/3D game engine** with a TypeScript SDK driven by a high-performance **C++** core — as WebAssembly on the web, and compiled ahead of time on native platforms. It outputs games that run in **web browsers**, on the **desktop**, in **WeChat MiniGames**, as single-file **playable ads**, and as native **Android / iOS** apps. A visual editor is available as a separate, free download.+Estella is a **2D and 3D game engine** — sprites, tilemaps and UI as much as lit, shadowed, physically simulated 3D worlds — with a TypeScript SDK driven by a high-performance **C++** core — as WebAssembly on the web, and compiled ahead of time on native platforms. It outputs games that run in **web browsers**, on the **desktop**, in **WeChat MiniGames**, as single-file **playable ads**, and as native **Android / iOS** apps. A visual editor is available as a separate, free download.<div align="center"><img src="docs/assets/editor-hero-c5bfd2f3.png" alt="An action-RPG scene open in the Estella editor" width="900" />@@ -31,12 +31,13 @@ Estella is a **2D/3D game engine** with a TypeScript SDK driven by a high-perfor## Why Estella?+- **2D and 3D, one engine** — Sprites, tilemaps, UI and Spine alongside PBR-lit models, shadows, baked lighting and 3D physics, in the same scene, editor and export pipeline- **Fast** — C++ rendering pipeline compiled to WebAssembly, not interpreted JS- **Type-safe** — First-class TypeScript SDK with `defineSystem`, `defineComponent`, and `Query`- **Data-oriented** — Entity-Component-System architecture for scalable game logic- **Visual editor** — Scene hierarchy, inspector, asset browser — no JSON editing- **Cross-platform** — One codebase, deploy to web, desktop, WeChat MiniGames, playable ads, and native mobile-- **Spine & Physics** — Built-in Spine animation and physics support+- **Animation & Physics** — Built-in Spine animation, skeletal animation, and 2D and 3D physics- **Agent-native** — The editor is an MCP server and ships an agent of its own; both drive the same tools its UI does## Features@@ -45,7 +46,9 @@ Estella is a **2D/3D game engine** with a TypeScript SDK driven by a high-perfor|---------|-------------|| **Visual Editor** | Scene editor with hierarchy, inspector, and asset management || **ECS Architecture** | Compose entities from reusable components, drive behavior with systems |-| **WebGL / WebGPU Rendering** | Sprites, cameras, Spine animations, custom shaders — all in WebAssembly |+| **2D** | Sprites, tilemaps, UI, text, Spine and DragonBones animation, 2D physics, particles, lighting |+| **3D** | glTF / FBX import, PBR materials, directional / point / spot lights with shadows, HDRI environments, baked lightmaps and light probes, reflection probes, decals, 3D physics, skeletal animation, navigation, post-processing, streamed large worlds |+| **WebGL / WebGPU Rendering** | One renderer for 2D and 3D, custom shaders — all in WebAssembly || **TypeScript SDK** | Type-safe API: `defineSystem`, `defineComponent`, `Query`, `Commands` || **Cross-Platform** | One project → web, desktop, WeChat MiniGames, playable ads, and native Android / iOS || **Native mobile** | A real arm64 app rendering through an embedded Dawn (Metal / Vulkan) — not a WebView |diff --git a/docs/astro/src/content/docs/getting-started/introduction.mdx b/docs/astro/src/content/docs/getting-started/introduction.mdxindex 37805ab7c..2e7eeb048 100644--- a/docs/astro/src/content/docs/getting-started/introduction.mdx+++ b/docs/astro/src/content/docs/getting-started/introduction.mdx@@ -3,7 +3,7 @@ title: Introductiondescription: What Estella is and why it exists.----Estella is a **2D game engine** with a TypeScript SDK driven by a+Estella is a **2D and 3D game engine** with a TypeScript SDK driven by ahigh-performance **C++/WebAssembly** backend. It ships with a visual editor forscene editing and project management, and exports one project to **the web,desktop, WeChat MiniGames, playable ads, and native Android / iOS apps**.diff --git a/docs/astro/src/content/docs/index.mdx b/docs/astro/src/content/docs/index.mdxindex c3c0b9145..e8404ff24 100644--- a/docs/astro/src/content/docs/index.mdx+++ b/docs/astro/src/content/docs/index.mdx@@ -1,9 +1,9 @@---title: Estella-description: A fast 2D game engine powered by WebAssembly and ECS, with a visual editor.+description: A fast 2D and 3D game engine powered by WebAssembly and ECS, with a visual editor.template: splashhero:- tagline: A fast 2D game engine with a TypeScript SDK, a C++/WebAssembly core, and a visual editor an AI agent can drive as well as you can. Ship one project to the web, desktop, WeChat MiniGames, playable ads, and native Android / iOS apps.+ tagline: A fast 2D and 3D game engine with a TypeScript SDK, a C++/WebAssembly core, and a visual editor an AI agent can drive as well as you can. Ship one project to the web, desktop, WeChat MiniGames, playable ads, and native Android / iOS apps.actions:- text: Get Startedlink: /docs/getting-started/introduction/diff --git a/docs/astro/src/content/docs/zh-cn/getting-started/introduction.mdx b/docs/astro/src/content/docs/zh-cn/getting-started/introduction.mdxindex 7a6c71b0c..0b813e952 100644--- a/docs/astro/src/content/docs/zh-cn/getting-started/introduction.mdx+++ b/docs/astro/src/content/docs/zh-cn/getting-started/introduction.mdx@@ -3,7 +3,7 @@ title: 简介description: Estella 是什么,以及它为什么存在。----Estella 是一个 **2D 游戏引擎**:上层是 TypeScript SDK,底层由高性能的+Estella 是一个 **2D 与 3D 游戏引擎**:上层是 TypeScript SDK,底层由高性能的**C++/WebAssembly** 内核驱动。它自带一个用于场景编辑与项目管理的可视化编辑器,把一个项目导出到 **Web、桌面、微信小游戏、Playable 广告,以及原生 Android / iOS 应用**。diff --git a/docs/astro/src/content/docs/zh-cn/index.mdx b/docs/astro/src/content/docs/zh-cn/index.mdxindex 1f5a0eb0d..006f21169 100644--- a/docs/astro/src/content/docs/zh-cn/index.mdx+++ b/docs/astro/src/content/docs/zh-cn/index.mdx@@ -1,9 +1,9 @@---title: Estella-description: 由 WebAssembly 与 ECS 驱动的高性能 2D 游戏引擎,带可视化编辑器。+description: 由 WebAssembly 与 ECS 驱动的高性能 2D 与 3D 游戏引擎,带可视化编辑器。template: splashhero:- tagline: 一个高性能 2D 游戏引擎——TypeScript SDK、C++/WebAssembly 内核,以及一个 AI 智能体能像你一样操作的可视化编辑器。一个项目发布到 Web、桌面、微信小游戏、Playable 广告,以及原生 Android / iOS 应用。+ tagline: 一个高性能 2D 与 3D 游戏引擎——TypeScript SDK、C++/WebAssembly 内核,以及一个 AI 智能体能像你一样操作的可视化编辑器。一个项目发布到 Web、桌面、微信小游戏、Playable 广告,以及原生 Android / iOS 应用。actions:- text: 快速开始link: /docs/zh-cn/getting-started/introduction/