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: add tilemap deep-dive and Sequencer screenshots (en + zh)

yhh6773738f1994
diff --git a/docs/astro/src/assets/guides/en/orient-hex.png b/docs/astro/src/assets/guides/en/orient-hex.png
new file mode 100644
index 000000000..ba9d10b9a
Binary files /dev/null and b/docs/astro/src/assets/guides/en/orient-hex.png differ
diff --git a/docs/astro/src/assets/guides/en/orient-staggered.png b/docs/astro/src/assets/guides/en/orient-staggered.png
new file mode 100644
index 000000000..eaf949b59
Binary files /dev/null and b/docs/astro/src/assets/guides/en/orient-staggered.png differ
diff --git a/docs/astro/src/assets/guides/en/seq-curves.png b/docs/astro/src/assets/guides/en/seq-curves.png
new file mode 100644
index 000000000..28116bfe8
Binary files /dev/null and b/docs/astro/src/assets/guides/en/seq-curves.png differ
diff --git a/docs/astro/src/assets/guides/en/seq-dopesheet.png b/docs/astro/src/assets/guides/en/seq-dopesheet.png
new file mode 100644
index 000000000..2849a79d4
Binary files /dev/null and b/docs/astro/src/assets/guides/en/seq-dopesheet.png differ
diff --git a/docs/astro/src/assets/guides/en/tilemap-new.png b/docs/astro/src/assets/guides/en/tilemap-new.png
new file mode 100644
index 000000000..7919e479f
Binary files /dev/null and b/docs/astro/src/assets/guides/en/tilemap-new.png differ
diff --git a/docs/astro/src/assets/guides/en/tileset-animation.png b/docs/astro/src/assets/guides/en/tileset-animation.png
new file mode 100644
index 000000000..db27657ee
Binary files /dev/null and b/docs/astro/src/assets/guides/en/tileset-animation.png differ
diff --git a/docs/astro/src/assets/guides/en/tileset-collision.png b/docs/astro/src/assets/guides/en/tileset-collision.png
new file mode 100644
index 000000000..916da7dcb
Binary files /dev/null and b/docs/astro/src/assets/guides/en/tileset-collision.png differ
diff --git a/docs/astro/src/assets/guides/en/tileset-terrain.png b/docs/astro/src/assets/guides/en/tileset-terrain.png
new file mode 100644
index 000000000..447cbc5a2
Binary files /dev/null and b/docs/astro/src/assets/guides/en/tileset-terrain.png differ
diff --git a/docs/astro/src/assets/guides/zh/orient-hex.png b/docs/astro/src/assets/guides/zh/orient-hex.png
new file mode 100644
index 000000000..57220f540
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/orient-hex.png differ
diff --git a/docs/astro/src/assets/guides/zh/orient-staggered.png b/docs/astro/src/assets/guides/zh/orient-staggered.png
new file mode 100644
index 000000000..abfe86050
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/orient-staggered.png differ
diff --git a/docs/astro/src/assets/guides/zh/seq-curves.png b/docs/astro/src/assets/guides/zh/seq-curves.png
new file mode 100644
index 000000000..03ac727a2
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/seq-curves.png differ
diff --git a/docs/astro/src/assets/guides/zh/seq-dopesheet.png b/docs/astro/src/assets/guides/zh/seq-dopesheet.png
new file mode 100644
index 000000000..23c680615
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/seq-dopesheet.png differ
diff --git a/docs/astro/src/assets/guides/zh/tilemap-new.png b/docs/astro/src/assets/guides/zh/tilemap-new.png
new file mode 100644
index 000000000..b9dba2673
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/tilemap-new.png differ
diff --git a/docs/astro/src/assets/guides/zh/tileset-animation.png b/docs/astro/src/assets/guides/zh/tileset-animation.png
new file mode 100644
index 000000000..27513ec6b
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/tileset-animation.png differ
diff --git a/docs/astro/src/assets/guides/zh/tileset-collision.png b/docs/astro/src/assets/guides/zh/tileset-collision.png
new file mode 100644
index 000000000..3ee0ec84a
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/tileset-collision.png differ
diff --git a/docs/astro/src/assets/guides/zh/tileset-terrain.png b/docs/astro/src/assets/guides/zh/tileset-terrain.png
new file mode 100644
index 000000000..c5732fdf5
Binary files /dev/null and b/docs/astro/src/assets/guides/zh/tileset-terrain.png differ
diff --git a/docs/astro/src/content/docs/guides/tilemap.mdx b/docs/astro/src/content/docs/guides/tilemap.mdx
index fa8fc5b17..ada867f7f 100644
--- a/docs/astro/src/content/docs/guides/tilemap.mdx
+++ b/docs/astro/src/content/docs/guides/tilemap.mdx
@@ -76,6 +76,20 @@ same fields afterwards. The viewport follows the layer: the grid overlay,
brush ghost, hover/selection highlights, and every paint tool work on the
diamond or hex grid exactly as they do on squares.
+![The New Tilemap dialog — orientation picker and tileset list](../../../assets/guides/en/tilemap-new.png)
+
+*The **New Tilemap** dialog picks the orientation and the tileset up front.*
+
+The same map painted on a hexagonal and a staggered grid:
+
+![A hexagonal tilemap in the viewport](../../../assets/guides/en/orient-hex.png)
+
+*Hexagonal — the grid, brush ghost, and every tool follow the hex layout.*
+
+![A staggered-isometric tilemap in the viewport](../../../assets/guides/en/orient-staggered.png)
+
+*Staggered isometric — alternate rows shift by half a cell.*
+
| `TilemapLayer` field | Values | Description |
|---|---|---|
| `orientation` | Orthogonal / Isometric / Staggered / Hexagonal | Grid layout of the layer. |
@@ -187,6 +201,10 @@ tiles carry a ▶ mark in the atlas. The frames are saved into the `.estileset`,
every layer that uses the tileset plays them automatically — in the editor viewport
and at runtime, no code required.
+![The Tileset editor in Animation mode — a tile's frame strip with per-frame durations](../../../assets/guides/en/tileset-animation.png)
+
+*Animation mode: pick a tile (here #34), click atlas tiles to append frames, and set each frame's duration in ms. The strip loops as a live preview.*
+
For procedural layers, `setTileAnimation` does the same from code — the plugin
advances it every frame:
@@ -209,6 +227,10 @@ tilemap.setChunkTiles(layer, chunkX, chunkY, tiles, 32, 32);
## Terrain autotiling
+![The Tileset editor in Terrain mode — a corner-Wang set with Grass / Sand / Water colors](../../../assets/guides/en/tileset-terrain.png)
+
+*Terrain mode with a **corner-Wang** set: define terrain colors (Grass / Sand / Water), then paint each tile's corners — the `T` brush later resolves the right tile from the neighbours.*
+
Terrains make the `T` brush paint *meaning* instead of specific tiles — you say
"grass here" and the resolver picks the tile whose edges match the neighbors.
Author terrains in the **Tileset editor**'s Terrain mode; a terrain set uses one
@@ -238,6 +260,10 @@ The engine's first-class tileset asset is **`.estileset`** — it references an
texture and carries per-tile collision, animation, terrain/auto-tile data, and
custom key/value properties.
+![The Tileset editor in Collision mode — shape tabs, modifiers, slope presets, and collision overlays on the atlas](../../../assets/guides/en/tileset-collision.png)
+
+*The **Tileset editor**'s Collision mode: pick a shape (**Box / Polygon / Circle**), toggle **one-way / sensor** and set friction / bounce / density, drop **slope** presets — the green overlay marks each tile's collider.*
+
Per-tile collision goes well beyond solid squares. In the tileset editor's
**Collision** mode you author, per tile:
diff --git a/docs/astro/src/content/docs/guides/timeline.mdx b/docs/astro/src/content/docs/guides/timeline.mdx
index 7f6b6ac1e..7731c16ea 100644
--- a/docs/astro/src/content/docs/guides/timeline.mdx
+++ b/docs/astro/src/content/docs/guides/timeline.mdx
@@ -95,6 +95,24 @@ A timeline is a set of tracks evaluated together each frame:
| Marker | `Marker` | Named time markers. |
| Custom event | `CustomEvent` | Named events with a payload, for your own systems. |
+## Author in the Sequencer
+
+Double-click an `.estimeline` (or open the timeline of a selected entity) to author
+it in the **Sequencer** — the editor for keyframe animation. The **dope sheet** lays
+every track and its keys along a shared, scrubbable playhead; add tracks, drag keys,
+then **Save**.
+
+![The Sequencer dope sheet — tracks and keyframes for a cutscene timeline](../../../assets/guides/en/seq-dopesheet.png)
+
+*The dope sheet: one row per track (here a Transform's `position.x` / `position.y` plus two letterbox activation tracks), keyframes as diamonds, a scrubbable playhead, and the transport up top.*
+
+Switch to the **Curves** tab to shape the interpolation between keys — drag the value
+curves and their tangent handles for eases the dope sheet can't express:
+
+![The Sequencer curve editor — value curves with tangent handles](../../../assets/guides/en/seq-curves.png)
+
+*The curve editor: each keyframed channel becomes an editable curve (here `position.x` easing in, `position.y` bobbing), with per-key tangent handles.*
+
## Timelines from code
An `.estimeline` document is plain data — the `TimelineAsset` type plus the
diff --git a/docs/astro/src/content/docs/zh-cn/guides/tilemap.mdx b/docs/astro/src/content/docs/zh-cn/guides/tilemap.mdx
index 846f59e59..9a775a4c7 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/tilemap.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/tilemap.mdx
@@ -64,6 +64,20 @@ Tiled 文件导入,无需额外设置。
轴/起始行与六边形边长;之后 Inspector 编辑同一组字段。视口完全跟随图层:网格覆盖层、
画笔虚影、悬停/选区高亮和所有绘制工具在菱形或六边形网格上的表现与方格完全一致。
+![新建瓦片地图对话框——朝向选择器与图集列表](../../../../assets/guides/zh/tilemap-new.png)
+
+***新建瓦片地图**对话框在最开始就选好朝向与图集。*
+
+同一张地图画在六边形与交错网格上:
+
+![视口里的六边形瓦片地图](../../../../assets/guides/zh/orient-hex.png)
+
+*六边形——网格、画笔虚影和所有工具都跟随六边形布局。*
+
+![视口里的交错等距瓦片地图](../../../../assets/guides/zh/orient-staggered.png)
+
+*交错等距——隔行平移半格。*
+
| `TilemapLayer` 字段 | 取值 | 说明 |
|---|---|---|
| `orientation` | Orthogonal / Isometric / Staggered / Hexagonal | 图层的网格布局。 |
@@ -168,6 +182,10 @@ tilemap.setTilesets(layer, [
(毫秒)和删除/清空操作;带动画的瓦片在图集里有 ▶ 标记。帧数据保存进 `.estileset`,
所有使用该图集的图层都会自动播放——编辑器视口和运行时皆然,无需一行代码。
+![图集编辑器的动画模式——某个瓦片的帧条带与逐帧时长](../../../../assets/guides/zh/tileset-animation.png)
+
+*动画模式:选一个瓦片(这里是 #34),点击图集瓦片追加帧,并以毫秒设置每帧时长。条带作为实时预览循环播放。*
+
程序化图层用 `setTileAnimation` 从代码做同样的事——插件每帧推进它:
```typescript
@@ -189,6 +207,10 @@ tilemap.setChunkTiles(layer, chunkX, chunkY, tiles, 32, 32);
## 地形自动拼接
+![图集编辑器的地形模式——带 Grass / Sand / Water 颜色的角 Wang 集](../../../../assets/guides/zh/tileset-terrain.png)
+
+*地形模式里的**角 Wang** 集:定义地形颜色(Grass / Sand / Water),再给每个瓦片的四角上色——之后 `T` 画笔据此从邻居解析出正确的瓦片。*
+
地形让 `T` 画笔绘制的是*含义*而不是具体瓦片——你说"这里是草地",解析器自动挑出
边缘与邻居吻合的那块瓦片。地形在**图集编辑器**的地形模式里创作;一个地形集使用
两种模型之一:
@@ -210,6 +232,10 @@ tilemap.setChunkTiles(layer, chunkX, chunkY, tiles, 32, 32);
引擎的一等图集资源是 **`.estileset`**——它引用一张图集纹理,并携带逐瓦片的碰撞、动画、
地形/自动拼接(auto-tile)数据与自定义键值属性。
+![图集编辑器的碰撞模式——形状标签、修饰、斜坡预设,以及图集上的碰撞覆盖](../../../../assets/guides/zh/tileset-collision.png)
+
+***图集编辑器**的碰撞模式:选形状(**盒 / 多边形 / 圆**)、切换**单向 / 传感器**并设置摩擦 / 弹性 / 密度、放置**斜坡**预设——绿色覆盖标出每个瓦片的碰撞体。*
+
逐瓦片碰撞远不止实心方块。在图集编辑器的 **碰撞** 模式里,你可以为每个瓦片编辑:
- **形状**——整格 **方块**(可拖刷)、内切 **圆形**(可拖刷),或经顶点编辑器的自由
diff --git a/docs/astro/src/content/docs/zh-cn/guides/timeline.mdx b/docs/astro/src/content/docs/zh-cn/guides/timeline.mdx
index 033ea595f..9affbde65 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/timeline.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/timeline.mdx
@@ -91,6 +91,22 @@ const control = defineSystem([Query(TimelinePlayer), Res(Timeline)], (q, timelin
| 标记 | `Marker` | 命名时间标记。 |
| 自定义事件 | `CustomEvent` | 带 payload 的命名事件,供你自己的系统消费。 |
+## 在 Sequencer 里创作
+
+双击一个 `.estimeline`(或打开选中实体的时间轴),就在 **Sequencer**(关键帧动画编辑器)里
+创作它。**摊开表(dope sheet)**把每条轨道及其关键帧沿一条共享、可拖动的播放头排开;加轨道、
+拖关键帧,然后 **Save**。
+
+![Sequencer 摊开表——一段过场时间轴的轨道与关键帧](../../../../assets/guides/zh/seq-dopesheet.png)
+
+*摊开表:一轨一行(这里是某 Transform 的 `position.x` / `position.y`,加两条黑边激活轨道),关键帧是菱形,播放头可拖动,顶部是走带控制。*
+
+切到 **Curves** 标签可塑形关键帧之间的插值——拖动值曲线及其切线手柄,做出摊开表表达不了的缓动:
+
+![Sequencer 曲线编辑器——带切线手柄的值曲线](../../../../assets/guides/zh/seq-curves.png)
+
+*曲线编辑器:每个关键帧通道变成一条可编辑曲线(这里 `position.x` 缓入、`position.y` 起伏),每个关键帧带切线手柄。*
+
## 用代码构建时间轴
`.estimeline` 文档就是普通数据——用 `TimelineAsset` 类型加上 `TrackType` /