Skip to content

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.

docs: describe Estella as a 2D and 3D engine

yhh6f783e1070fb
diff --git a/AGENTS.md b/AGENTS.md
index 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 updating
roadmap completion. A merged PR alone does not prove device acceptance.
- Do not add generated-by attribution or assistant co-author trailers to
diff --git a/README.md b/README.md
index 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**
[![CI](https://github.com/esengine/estella/actions/workflows/build.yml/badge.svg)](https://github.com/esengine/estella/actions/workflows/build.yml)
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](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.mdx
index 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: Introduction
description: 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 a
high-performance **C++/WebAssembly** backend. It ships with a visual editor for
scene 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.mdx
index 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: splash
hero:
- 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 Started
link: /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.mdx
index 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.mdx
index 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: splash
hero:
- 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/