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: the editor an agent can drive is a headline feature, not an extension point
yhhf30223ff9155
diff --git a/README.md b/README.mdindex c0984d7b8..5a91af803 100644--- a/README.md+++ b/README.md@@ -37,6 +37,7 @@ Estella is a **2D game engine** with a TypeScript SDK driven by a high-performan- **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+- **Agent-native** — The editor is an MCP server and ships an agent of its own; both drive the same tools its UI does## Features@@ -48,6 +49,7 @@ Estella is a **2D game engine** with a TypeScript SDK driven by a high-performan| **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 |+| **AI agents** | The editor is an MCP server with 65 tools, and ships a built-in agent that drives the same ones |## Getting Started@@ -88,6 +90,23 @@ addSystem(defineSystem(Press **F5** in the editor to preview.+## Let an agent build it++The editor speaks the **Model Context Protocol**. Point Claude Code, Cursor, or any+MCP-capable tool at it and the agent drives the real editor — opens projects, spawns+entities from the same Create menu you use, edits component fields, enters play mode,+takes a screenshot to *see* what it built, and exports the finished game. Sixty-five+tools, all of them the pipelines the UI itself calls.++It also ships an agent of its own, so you don't need an external tool to start: type a+sentence in the editor and watch every tool call it makes. Both front doors drive one+catalog — what the built-in agent can do and what your MCP client can do are the same+list, and both go through the editor's command surface, so creates are undoable and you+can take the mouse back mid-turn.++- [The Built-in Agent](https://estellaengine.com/docs/agents/built-in/) — set up a provider and start asking+- [External Agents (MCP)](https://estellaengine.com/docs/agents/mcp/) — connect Claude Code, Cursor, or your own+## DocumentationFull documentation: [estellaengine.com/docs](https://estellaengine.com/docs)@@ -100,6 +119,7 @@ Full documentation: [estellaengine.com/docs](https://estellaengine.com/docs)- [Systems](https://estellaengine.com/docs/core-concepts/systems/)- [Building & Exporting](https://estellaengine.com/docs/publishing/overview/)- [Android & iOS](https://estellaengine.com/docs/publishing/android-ios/)+- [AI Agents](https://estellaengine.com/docs/agents/built-in/)## Contributingdiff --git a/docs/astro/astro.config.mjs b/docs/astro/astro.config.mjsindex 3d3092485..a00306243 100644--- a/docs/astro/astro.config.mjs+++ b/docs/astro/astro.config.mjs@@ -69,8 +69,10 @@ const MOVED = {'guides/services': 'publishing/ads-sharing','guides/profiling': 'performance/profiling','guides/editor-plugins': 'extending/editor-plugins',- 'guides/agent': 'extending/built-in-agent',- 'guides/mcp': 'extending/mcp',+ 'guides/agent': 'agents/built-in',+ 'guides/mcp': 'agents/mcp',+ 'extending/built-in-agent': 'agents/built-in',+ 'extending/mcp': 'agents/mcp',};// The site is deployed under estellaengine.com/docs (docs.yml merges this build@@ -170,6 +172,18 @@ export default defineConfig({{ label: 'Keyboard Shortcuts', translations: { 'zh-CN': '键盘快捷键' }, slug: 'editor/shortcuts' },],},+ {+ // Driving the editor, not extending it — which is why this sits beside+ // the editor rather than under "Extending", where it read as a plugin+ // topic. Both pages describe one tool catalog with two front doors.+ label: 'AI Agents',+ translations: { 'zh-CN': 'AI 智能体' },+ collapsed: true,+ items: [+ { label: 'The Built-in Agent', translations: { 'zh-CN': '内置智能体' }, slug: 'agents/built-in' },+ { label: 'External Agents (MCP)', translations: { 'zh-CN': '外部智能体 (MCP)' }, slug: 'agents/mcp' },+ ],+ },{label: 'Core Concepts',translations: { 'zh-CN': '核心概念' },@@ -312,8 +326,6 @@ export default defineConfig({collapsed: true,items: [{ label: 'Editor Plugins', translations: { 'zh-CN': '编辑器插件' }, slug: 'extending/editor-plugins' },- { label: 'The Built-in Agent', translations: { 'zh-CN': '内置 Agent' }, slug: 'extending/built-in-agent' },- { label: 'AI Agents (MCP)', translations: { 'zh-CN': 'AI 代理 (MCP)' }, slug: 'extending/mcp' },],},{diff --git a/docs/astro/src/content/docs/extending/built-in-agent.mdx b/docs/astro/src/content/docs/agents/built-in.mdxsimilarity index 98%rename from docs/astro/src/content/docs/extending/built-in-agent.mdxrename to docs/astro/src/content/docs/agents/built-in.mdxindex 1c6803e16..8fb7b4103 100644--- a/docs/astro/src/content/docs/extending/built-in-agent.mdx+++ b/docs/astro/src/content/docs/agents/built-in.mdx@@ -8,7 +8,7 @@ import { Aside, Steps } from '@astrojs/starlight/components';The editor ships with an agent of its own. You type a sentence; it reads the scene,calls the same tools the editor's UI calls, and shows you every one of them as itgoes. Nothing about it is a separate copy of the editor: it drives the exact tool-catalog an [external MCP client](/docs/extending/mcp/) drives, so what it can do and+catalog an [external MCP client](/docs/agents/mcp/) drives, so what it can do andwhat the editor can do are one list.<Aside type="tip">@@ -161,7 +161,7 @@ screen: they show what it actually looked at.## See also-- [AI Agents (MCP)](/docs/extending/mcp/) — the same tool catalog, driven from Claude+- [AI Agents (MCP)](/docs/agents/mcp/) — the same tool catalog, driven from ClaudeCode, Cursor, or your own agent instead of from inside the editor.- [Event Binding](/docs/scripting/events/) — what the agent reaches for when you askfor behaviour without code.diff --git a/docs/astro/src/content/docs/extending/mcp.mdx b/docs/astro/src/content/docs/agents/mcp.mdxsimilarity index 100%rename from docs/astro/src/content/docs/extending/mcp.mdxrename to docs/astro/src/content/docs/agents/mcp.mdxdiff --git a/docs/astro/src/content/docs/index.mdx b/docs/astro/src/content/docs/index.mdxindex 052e004c0..c3c0b9145 100644--- a/docs/astro/src/content/docs/index.mdx+++ b/docs/astro/src/content/docs/index.mdx@@ -3,7 +3,7 @@ title: Estelladescription: A fast 2D 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. Ship one project to the web, desktop, WeChat MiniGames, playable ads, and native Android / iOS apps.+ 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.actions:- text: Get Startedlink: /docs/getting-started/introduction/@@ -43,6 +43,11 @@ import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';One project, exported to the web, desktop, WeChat MiniGames, single-fileplayable ads, and native Android / iOS apps.</Card>+ <Card title="Agent-native" icon="comment">+ The editor is an MCP server, and it ships an agent of its own. Both drive the+ same sixty-five tools the UI does — so an agent can build a scene, press play,+ and look at a screenshot of what it made.+ </Card></CardGrid>## Dive in@@ -53,5 +58,6 @@ import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';<LinkCard title="Sprites & Rendering" href="/docs/graphics/sprites/" description="Draw images — tint, size, sort, and layer them." /><LinkCard title="Physics" href="/docs/gameplay/physics/" description="Rigid bodies, colliders, joints, and spatial queries." /><LinkCard title="Gameplay AI" href="/docs/gameplay/ai/overview/" description="Navigation, perception, state machines, behavior trees." />+ <LinkCard title="AI Agents" href="/docs/agents/built-in/" description="Ask the editor to build it — from the built-in agent or your own MCP client." /><LinkCard title="Building & Exporting" href="/docs/publishing/overview/" description="Ship to web, desktop, WeChat, playable ads, Android and iOS." /></CardGrid>diff --git a/docs/astro/src/content/docs/zh-cn/extending/built-in-agent.mdx b/docs/astro/src/content/docs/zh-cn/agents/built-in.mdxsimilarity index 97%rename from docs/astro/src/content/docs/zh-cn/extending/built-in-agent.mdxrename to docs/astro/src/content/docs/zh-cn/agents/built-in.mdxindex 90d36fb3e..7993bcbe3 100644--- a/docs/astro/src/content/docs/zh-cn/extending/built-in-agent.mdx+++ b/docs/astro/src/content/docs/zh-cn/agents/built-in.mdx@@ -7,7 +7,7 @@ import { Aside, Steps } from '@astrojs/starlight/components';编辑器自带一个 Agent。你打一句话,它读场景、调用编辑器 UI 调用的同一批工具,并把每一次调用都摊在你眼前。它不是编辑器的另一份复制品:它驱动的工具目录,-和[外部 MCP 客户端](/docs/zh-cn/extending/mcp/)驱动的是同一份——它能做什么,+和[外部 MCP 客户端](/docs/zh-cn/agents/mcp/)驱动的是同一份——它能做什么,和编辑器能做什么,是一张清单。<Aside type="tip">@@ -142,7 +142,7 @@ import { Aside, Steps } from '@astrojs/starlight/components';## 参见-- [AI 代理 (MCP)](/docs/zh-cn/extending/mcp/) —— 同一份工具目录,+- [AI 代理 (MCP)](/docs/zh-cn/agents/mcp/) —— 同一份工具目录,只不过是从 Claude Code、Cursor 或你自己的代理去驱动,而不是从编辑器内部。- [事件绑定](/docs/zh-cn/scripting/events/) —— 你要求"不写代码的行为"时,Agent 会去用的东西。- [预制体](/docs/zh-cn/world/prefabs/) —— 在预制体模式下,Agent 编辑的是预制体而不是场景。diff --git a/docs/astro/src/content/docs/zh-cn/extending/mcp.mdx b/docs/astro/src/content/docs/zh-cn/agents/mcp.mdxsimilarity index 100%rename from docs/astro/src/content/docs/zh-cn/extending/mcp.mdxrename to docs/astro/src/content/docs/zh-cn/agents/mcp.mdxdiff --git a/docs/astro/src/content/docs/zh-cn/index.mdx b/docs/astro/src/content/docs/zh-cn/index.mdxindex 2861298f9..1f5a0eb0d 100644--- a/docs/astro/src/content/docs/zh-cn/index.mdx+++ b/docs/astro/src/content/docs/zh-cn/index.mdx@@ -3,7 +3,7 @@ title: Estelladescription: 由 WebAssembly 与 ECS 驱动的高性能 2D 游戏引擎,带可视化编辑器。template: splashhero:- tagline: 一个高性能 2D 游戏引擎——TypeScript SDK、C++/WebAssembly 内核、可视化编辑器。一个项目发布到 Web、桌面、微信小游戏、Playable 广告,以及原生 Android / iOS 应用。+ tagline: 一个高性能 2D 游戏引擎——TypeScript SDK、C++/WebAssembly 内核,以及一个 AI 智能体能像你一样操作的可视化编辑器。一个项目发布到 Web、桌面、微信小游戏、Playable 广告,以及原生 Android / iOS 应用。actions:- text: 快速开始link: /docs/zh-cn/getting-started/introduction/@@ -39,6 +39,10 @@ import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';<Card title="跨平台" icon="laptop">一个项目,导出到 Web、桌面、微信小游戏、单文件 Playable 广告,以及原生 Android / iOS 应用。</Card>+ <Card title="为智能体而生" icon="comment">+ 编辑器本身就是一个 MCP 服务器,还自带一个智能体。两者驱动的都是 UI 用的那 65 个工具——+ 所以智能体能搭好场景、按下运行,再看一眼自己做出来的截图。+ </Card></CardGrid>## 上手@@ -49,5 +53,6 @@ import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';<LinkCard title="精灵与渲染" href="/docs/zh-cn/graphics/sprites/" description="绘制图像——着色、尺寸、排序与分层。" /><LinkCard title="物理" href="/docs/zh-cn/gameplay/physics/" description="刚体、碰撞体、关节与空间查询。" /><LinkCard title="游戏 AI" href="/docs/zh-cn/gameplay/ai/overview/" description="导航、感知、状态机、行为树。" />+ <LinkCard title="AI 智能体" href="/docs/zh-cn/agents/built-in/" description="让编辑器替你搭——用内置智能体,或你自己的 MCP 客户端。" /><LinkCard title="构建与导出" href="/docs/zh-cn/publishing/overview/" description="发布到 Web、桌面、微信、Playable 广告、Android 与 iOS。" /></CardGrid>