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: add "See also" cross-links to the guides that lacked them
esenginefeea809f1759
diff --git a/docs/astro/src/content/docs/guides/ai.mdx b/docs/astro/src/content/docs/guides/ai.mdxindex 7e438996e..e8196b81d 100644--- a/docs/astro/src/content/docs/guides/ai.mdx+++ b/docs/astro/src/content/docs/guides/ai.mdx@@ -574,3 +574,9 @@ The two enemies' `StateMachineAgent.fsm` and `BehaviorTreeAgent.bt` point at`enemy.esfsm` / `enemy.esbt` — authored in the editor, loaded by the engine.Perception, the FSM/BT ticks, and nav following are all built-in, so the only gamecode is the shared leaves above plus the one-time grid.++## See also++- [Scripting](/docs/guides/scripting/) — behaviors are declarative systems; leaves are plain functions.+- [Animation](/docs/guides/animation/) — drive sprite clips from a state machine.+- [Scenes](/docs/guides/scene/) — `.esfsm` / `.esbt` assets load and serialize with the scene.diff --git a/docs/astro/src/content/docs/guides/build-export.mdx b/docs/astro/src/content/docs/guides/build-export.mdxindex fe8cdbcd2..67f94ed3b 100644--- a/docs/astro/src/content/docs/guides/build-export.mdx+++ b/docs/astro/src/content/docs/guides/build-export.mdx@@ -179,3 +179,9 @@ node build-tools/cli.js watch # rebuild on change (engine dev)Most game developers never run the build CLI beyond the one-time WeChat / Playableruntime builds — day-to-day work happens in the editor and the SDK.</Aside>++## See also++- [WeChat MiniGame](/docs/guides/wechat/) — subpackage layout and platform-specific quirks.+- [Assets](/docs/guides/assets/) — how the cook step bundles and content-addresses assets.+- [Profiling & Diagnostics](/docs/guides/profiling/) — check frame time and draw calls before you ship.diff --git a/docs/astro/src/content/docs/guides/lighting.mdx b/docs/astro/src/content/docs/guides/lighting.mdxindex 02289de5c..675133a23 100644--- a/docs/astro/src/content/docs/guides/lighting.mdx+++ b/docs/astro/src/content/docs/guides/lighting.mdx@@ -208,3 +208,9 @@ const app = createWebApp(module, { colorSpace: 'linear' });- All of a light's visual fields (`color`, `intensity`, `radius`, the angles, and theshadow settings) are **animatable** — key them in the [Sequencer](/docs/guides/timeline/)for flickering torches, day/night cycles, or a pulsing beacon.++## See also++- [Materials & Shaders](/docs/guides/material/) — lit materials and custom shading.+- [Post-processing](/docs/guides/postprocess/) — bloom and color grading over the lit scene.+- [Sprites & Rendering](/docs/guides/sprites/) — normal maps that give 2D sprites depth under light.diff --git a/docs/astro/src/content/docs/guides/mcp.mdx b/docs/astro/src/content/docs/guides/mcp.mdxindex d3a6f8142..dd8ce50df 100644--- a/docs/astro/src/content/docs/guides/mcp.mdx+++ b/docs/astro/src/content/docs/guides/mcp.mdx@@ -105,3 +105,8 @@ In a source checkout, `pnpm --filter @estella/editor editor:mcp` serves the sameregistry against a headless fixtures host (scene tools only), `editor:mcp -- --editor`boots the dev editor, and two e2e suites (`editor:mcp:e2e`,`editor:mcp:editor-e2e`) prove the full loop.++## See also++- [The Editor](/docs/guides/editor/) — the visual editor this automation surface drives.+- [Scripting](/docs/guides/scripting/) — the same scene / component model, from game code.diff --git a/docs/astro/src/content/docs/guides/save.mdx b/docs/astro/src/content/docs/guides/save.mdxindex ad54407e9..5f39278b8 100644--- a/docs/astro/src/content/docs/guides/save.mdx+++ b/docs/astro/src/content/docs/guides/save.mdx@@ -93,3 +93,8 @@ backend.Both APIs are synchronous and back onto the platform's storage, which has a sizelimit (a few MB in browsers). Keep saves to game state — not bulk assets.</Aside>++## See also++- [Scenes](/docs/guides/scene/) — loading and switching the scenes a save points at.+- [Assets](/docs/guides/assets/) — why bulk data belongs in assets, not in a save slot.diff --git a/docs/astro/src/content/docs/guides/scripting.mdx b/docs/astro/src/content/docs/guides/scripting.mdxindex 5f3fa3a75..4ccc9c066 100644--- a/docs/astro/src/content/docs/guides/scripting.mdx+++ b/docs/astro/src/content/docs/guides/scripting.mdx@@ -241,3 +241,9 @@ that asks of your code:The mechanism (probe context, schema fingerprint, `App.hotSwapSystems`) isdocumented in [App Setup & Lifecycle](/docs/core-concepts/app-lifecycle/#hot-reload).++## See also++- [Systems](/docs/core-concepts/systems/) — the full query vocabulary, filters, and schedules.+- [ECS Architecture](/docs/core-concepts/ecs/) — entities, components, and how systems iterate them.+- [Input](/docs/guides/input/) — read keyboard, pointer, and gestures from a system.diff --git a/docs/astro/src/content/docs/guides/sprites.mdx b/docs/astro/src/content/docs/guides/sprites.mdxindex 2e813ef4e..b28b5435f 100644--- a/docs/astro/src/content/docs/guides/sprites.mdx+++ b/docs/astro/src/content/docs/guides/sprites.mdx@@ -363,3 +363,9 @@ without a depth buffer.Browser into the viewport to spawn one already textured.- Every field above is editable in **Details**; sprites, cameras, and lights show asgizmos in the viewport. See [The Editor](/docs/guides/editor/).++## See also++- [Animation](/docs/guides/animation/) — sprite-sheet flipbooks and tweened properties.+- [Custom Drawing](/docs/guides/drawing/) — meshes and immediate-mode shapes beyond sprites.+- [2D Lighting & Shadows](/docs/guides/lighting/) — normal maps and per-sprite lighting.diff --git a/docs/astro/src/content/docs/zh-cn/guides/ai.mdx b/docs/astro/src/content/docs/zh-cn/guides/ai.mdxindex d86d38a30..d42eac693 100644--- a/docs/astro/src/content/docs/zh-cn/guides/ai.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/ai.mdx@@ -530,3 +530,9 @@ export const setupNavGrid = defineSystem([Res(Nav)], (nav) => {两个敌人的 `StateMachineAgent.fsm` 和 `BehaviorTreeAgent.bt` 分别指向 `enemy.esfsm` /`enemy.esbt`——在编辑器里编排,由引擎加载。感知、FSM/BT 的 tick、以及跟随导航全是内置的,所以唯一的游戏代码就是上面的共享叶子加上那张一次性的网格。++## 参见++- [脚本](/docs/zh-cn/guides/scripting/) —— 行为是声明式系统;叶子就是普通函数。+- [动画](/docs/zh-cn/guides/animation/) —— 用状态机驱动精灵动画。+- [场景](/docs/zh-cn/guides/scene/) —— `.esfsm` / `.esbt` 资产随场景加载与序列化。diff --git a/docs/astro/src/content/docs/zh-cn/guides/build-export.mdx b/docs/astro/src/content/docs/zh-cn/guides/build-export.mdxindex de424f721..8cf54b7ad 100644--- a/docs/astro/src/content/docs/zh-cn/guides/build-export.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/build-export.mdx@@ -147,3 +147,9 @@ node build-tools/cli.js watch # 改动即重建(引擎开发)大多数游戏开发者除了那一次性的微信 / Playable 运行时构建外,从不需要动构建 CLI——日常工作都在编辑器和 SDK 里。</Aside>++## 参见++- [微信小游戏](/docs/zh-cn/guides/wechat/) —— 分包布局与平台差异。+- [资源](/docs/zh-cn/guides/assets/) —— cook 步骤如何打包与内容寻址资产。+- [性能剖析与诊断](/docs/zh-cn/guides/profiling/) —— 发布前检查帧时间与 draw call。diff --git a/docs/astro/src/content/docs/zh-cn/guides/lighting.mdx b/docs/astro/src/content/docs/zh-cn/guides/lighting.mdxindex 2f8b9137d..e60895c09 100644--- a/docs/astro/src/content/docs/zh-cn/guides/lighting.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/lighting.mdx@@ -195,3 +195,9 @@ const app = createWebApp(module, { colorSpace: 'linear' });- 在 Details 里实时调 `color`(取色器)、`intensity`、`radius` 和聚光角度;结果在视口里即时更新。- 一盏灯的全部视觉字段(`color`、`intensity`、`radius`、各角度、阴影设置)都**可动画**——在[Sequencer](/docs/zh-cn/guides/timeline/)里给它们打关键帧,做闪烁的火把、昼夜循环或脉动的信标。++## 参见++- [材质与着色器](/docs/zh-cn/guides/material/) —— 受光材质与自定义着色。+- [后处理](/docs/zh-cn/guides/postprocess/) —— 在受光场景上叠加辉光与调色。+- [精灵与渲染](/docs/zh-cn/guides/sprites/) —— 让 2D 精灵在光下有立体感的法线贴图。diff --git a/docs/astro/src/content/docs/zh-cn/guides/mcp.mdx b/docs/astro/src/content/docs/zh-cn/guides/mcp.mdxindex 7cb71e022..ef679f4b8 100644--- a/docs/astro/src/content/docs/zh-cn/guides/mcp.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/mcp.mdx@@ -99,3 +99,8 @@ claude mcp add estella --env ESTELLA_MCP_ALLOW_WRITES=1 -- \源码仓库里,`pnpm --filter @estella/editor editor:mcp` 用无头夹具宿主提供同一套注册表(仅场景工具),`editor:mcp -- --editor` 拉起开发版编辑器;两套 e2e(`editor:mcp:e2e`、`editor:mcp:editor-e2e`)验证完整闭环。++## 参见++- [编辑器](/docs/zh-cn/guides/editor/) —— 这个自动化面驱动的可视化编辑器。+- [脚本](/docs/zh-cn/guides/scripting/) —— 同一套场景 / 组件模型,从游戏代码这边看。diff --git a/docs/astro/src/content/docs/zh-cn/guides/save.mdx b/docs/astro/src/content/docs/zh-cn/guides/save.mdxindex 848e8af5b..61757709a 100644--- a/docs/astro/src/content/docs/zh-cn/guides/save.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/save.mdx@@ -86,3 +86,8 @@ Storage.has('keybinds'); // true两个 API 都是同步的,且落在平台的存储上,存储有大小限制(浏览器里通常几 MB)。存档只放游戏状态——不要放大块资源。</Aside>++## 参见++- [场景](/docs/zh-cn/guides/scene/) —— 加载与切换存档所指向的场景。+- [资源](/docs/zh-cn/guides/assets/) —— 为什么大块数据应放资源而非存档槽。diff --git a/docs/astro/src/content/docs/zh-cn/guides/scripting.mdx b/docs/astro/src/content/docs/zh-cn/guides/scripting.mdxindex 0aa8e4436..6d2bae723 100644--- a/docs/astro/src/content/docs/zh-cn/guides/scripting.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/scripting.mdx@@ -220,3 +220,9 @@ world.spawn()其机制(探针上下文、模式指纹、`App.hotSwapSystems`)见[应用设置与生命周期](/docs/zh-cn/core-concepts/app-lifecycle/#热重载)。++## 参见++- [系统](/docs/zh-cn/core-concepts/systems/) —— 完整的查询词汇、过滤器与调度。+- [ECS 架构](/docs/zh-cn/core-concepts/ecs/) —— 实体、组件,以及系统如何遍历它们。+- [输入](/docs/zh-cn/guides/input/) —— 在系统里读取键盘、指针与手势。diff --git a/docs/astro/src/content/docs/zh-cn/guides/sprites.mdx b/docs/astro/src/content/docs/zh-cn/guides/sprites.mdxindex 960d789dc..3e3862272 100644--- a/docs/astro/src/content/docs/zh-cn/guides/sprites.mdx+++ b/docs/astro/src/content/docs/zh-cn/guides/sprites.mdx@@ -330,3 +330,9 @@ Draw.texture(pos, { x: 512, y: 256 }, cache.textureId);- **创建 → 精灵** 添加一个精灵实体,或从内容浏览器**把图拖**进视口,生成一个已带纹理的精灵。- 上面每个字段都能在 **Details** 里编辑;精灵、相机、光源在视口里显示为 gizmo。见[编辑器](/docs/zh-cn/guides/editor/)。++## 参见++- [动画](/docs/zh-cn/guides/animation/) —— 精灵表帧动画与属性补间。+- [自定义绘制](/docs/zh-cn/guides/drawing/) —— 精灵之外的网格与即时模式图形。+- [2D 光照与阴影](/docs/zh-cn/guides/lighting/) —— 法线贴图与逐精灵光照。