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 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.pngnew file mode 100644index 000000000..ba9d10b9aBinary files /dev/null and b/docs/astro/src/assets/guides/en/orient-hex.png differdiff --git a/docs/astro/src/assets/guides/en/orient-staggered.png b/docs/astro/src/assets/guides/en/orient-staggered.pngnew file mode 100644index 000000000..eaf949b59Binary files /dev/null and b/docs/astro/src/assets/guides/en/orient-staggered.png differdiff --git a/docs/astro/src/assets/guides/en/seq-curves.png b/docs/astro/src/assets/guides/en/seq-curves.pngnew file mode 100644index 000000000..28116bfe8Binary files /dev/null and b/docs/astro/src/assets/guides/en/seq-curves.png differdiff --git a/docs/astro/src/assets/guides/en/seq-dopesheet.png b/docs/astro/src/assets/guides/en/seq-dopesheet.pngnew file mode 100644index 000000000..2849a79d4Binary files /dev/null and b/docs/astro/src/assets/guides/en/seq-dopesheet.png differdiff --git a/docs/astro/src/assets/guides/en/tilemap-new.png b/docs/astro/src/assets/guides/en/tilemap-new.pngnew file mode 100644index 000000000..7919e479fBinary files /dev/null and b/docs/astro/src/assets/guides/en/tilemap-new.png differdiff --git a/docs/astro/src/assets/guides/en/tileset-animation.png b/docs/astro/src/assets/guides/en/tileset-animation.pngnew file mode 100644index 000000000..db27657eeBinary files /dev/null and b/docs/astro/src/assets/guides/en/tileset-animation.png differdiff --git a/docs/astro/src/assets/guides/en/tileset-collision.png b/docs/astro/src/assets/guides/en/tileset-collision.pngnew file mode 100644index 000000000..916da7dcbBinary files /dev/null and b/docs/astro/src/assets/guides/en/tileset-collision.png differdiff --git a/docs/astro/src/assets/guides/en/tileset-terrain.png b/docs/astro/src/assets/guides/en/tileset-terrain.pngnew file mode 100644index 000000000..447cbc5a2Binary files /dev/null and b/docs/astro/src/assets/guides/en/tileset-terrain.png differdiff --git a/docs/astro/src/assets/guides/zh/orient-hex.png b/docs/astro/src/assets/guides/zh/orient-hex.pngnew file mode 100644index 000000000..57220f540Binary files /dev/null and b/docs/astro/src/assets/guides/zh/orient-hex.png differdiff --git a/docs/astro/src/assets/guides/zh/orient-staggered.png b/docs/astro/src/assets/guides/zh/orient-staggered.pngnew file mode 100644index 000000000..abfe86050Binary files /dev/null and b/docs/astro/src/assets/guides/zh/orient-staggered.png differdiff --git a/docs/astro/src/assets/guides/zh/seq-curves.png b/docs/astro/src/assets/guides/zh/seq-curves.pngnew file mode 100644index 000000000..03ac727a2Binary files /dev/null and b/docs/astro/src/assets/guides/zh/seq-curves.png differdiff --git a/docs/astro/src/assets/guides/zh/seq-dopesheet.png b/docs/astro/src/assets/guides/zh/seq-dopesheet.pngnew file mode 100644index 000000000..23c680615Binary files /dev/null and b/docs/astro/src/assets/guides/zh/seq-dopesheet.png differdiff --git a/docs/astro/src/assets/guides/zh/tilemap-new.png b/docs/astro/src/assets/guides/zh/tilemap-new.pngnew file mode 100644index 000000000..b9dba2673Binary files /dev/null and b/docs/astro/src/assets/guides/zh/tilemap-new.png differdiff --git a/docs/astro/src/assets/guides/zh/tileset-animation.png b/docs/astro/src/assets/guides/zh/tileset-animation.pngnew file mode 100644index 000000000..27513ec6bBinary files /dev/null and b/docs/astro/src/assets/guides/zh/tileset-animation.png differdiff --git a/docs/astro/src/assets/guides/zh/tileset-collision.png b/docs/astro/src/assets/guides/zh/tileset-collision.pngnew file mode 100644index 000000000..3ee0ec84aBinary files /dev/null and b/docs/astro/src/assets/guides/zh/tileset-collision.png differdiff --git a/docs/astro/src/assets/guides/zh/tileset-terrain.png b/docs/astro/src/assets/guides/zh/tileset-terrain.pngnew file mode 100644index 000000000..c5732fdf5Binary files /dev/null and b/docs/astro/src/assets/guides/zh/tileset-terrain.png differdiff --git a/docs/astro/src/content/docs/guides/tilemap.mdx b/docs/astro/src/content/docs/guides/tilemap.mdxindex 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 thediamond or hex grid exactly as they do on squares.+++*The **New Tilemap** dialog picks the orientation and the tileset up front.*++The same map painted on a hexagonal and a staggered grid:++++*Hexagonal — the grid, brush ghost, and every tool follow the hex layout.*++++*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 viewportand at runtime, no code required.+++*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 pluginadvances it every frame:@@ -209,6 +227,10 @@ tilemap.setChunkTiles(layer, chunkX, chunkY, tiles, 32, 32);## Terrain autotiling+++*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 antexture and carries per-tile collision, animation, terrain/auto-tile data, andcustom key/value properties.+++*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.mdxindex 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 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 curve editor: each keyframed channel becomes an editable curve (here `position.x` easing in, `position.y` bobbing), with per-key tangent handles.*+## Timelines from codeAn `.estimeline` document is plain data — the `TimelineAsset` type plus thediff --git a/docs/astro/src/content/docs/zh-cn/guides/tilemap.mdx b/docs/astro/src/content/docs/zh-cn/guides/tilemap.mdxindex 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 编辑同一组字段。视口完全跟随图层:网格覆盖层、画笔虚影、悬停/选区高亮和所有绘制工具在菱形或六边形网格上的表现与方格完全一致。+++***新建瓦片地图**对话框在最开始就选好朝向与图集。*++同一张地图画在六边形与交错网格上:++++*六边形——网格、画笔虚影和所有工具都跟随六边形布局。*++++*交错等距——隔行平移半格。*+| `TilemapLayer` 字段 | 取值 | 说明 ||---|---|---|| `orientation` | Orthogonal / Isometric / Staggered / Hexagonal | 图层的网格布局。 |@@ -168,6 +182,10 @@ tilemap.setTilesets(layer, [(毫秒)和删除/清空操作;带动画的瓦片在图集里有 ▶ 标记。帧数据保存进 `.estileset`,所有使用该图集的图层都会自动播放——编辑器视口和运行时皆然,无需一行代码。+++*动画模式:选一个瓦片(这里是 #34),点击图集瓦片追加帧,并以毫秒设置每帧时长。条带作为实时预览循环播放。*+程序化图层用 `setTileAnimation` 从代码做同样的事——插件每帧推进它:```typescript@@ -189,6 +207,10 @@ tilemap.setChunkTiles(layer, chunkX, chunkY, tiles, 32, 32);## 地形自动拼接+++*地形模式里的**角 Wang** 集:定义地形颜色(Grass / Sand / Water),再给每个瓦片的四角上色——之后 `T` 画笔据此从邻居解析出正确的瓦片。*+地形让 `T` 画笔绘制的是*含义*而不是具体瓦片——你说"这里是草地",解析器自动挑出边缘与邻居吻合的那块瓦片。地形在**图集编辑器**的地形模式里创作;一个地形集使用两种模型之一:@@ -210,6 +232,10 @@ tilemap.setChunkTiles(layer, chunkX, chunkY, tiles, 32, 32);引擎的一等图集资源是 **`.estileset`**——它引用一张图集纹理,并携带逐瓦片的碰撞、动画、地形/自动拼接(auto-tile)数据与自定义键值属性。+++***图集编辑器**的碰撞模式:选形状(**盒 / 多边形 / 圆**)、切换**单向 / 传感器**并设置摩擦 / 弹性 / 密度、放置**斜坡**预设——绿色覆盖标出每个瓦片的碰撞体。*+逐瓦片碰撞远不止实心方块。在图集编辑器的 **碰撞** 模式里,你可以为每个瓦片编辑:- **形状**——整格 **方块**(可拖刷)、内切 **圆形**(可拖刷),或经顶点编辑器的自由diff --git a/docs/astro/src/content/docs/zh-cn/guides/timeline.mdx b/docs/astro/src/content/docs/zh-cn/guides/timeline.mdxindex 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**。++++*摊开表:一轨一行(这里是某 Transform 的 `position.x` / `position.y`,加两条黑边激活轨道),关键帧是菱形,播放头可拖动,顶部是走带控制。*++切到 **Curves** 标签可塑形关键帧之间的插值——拖动值曲线及其切线手柄,做出摊开表表达不了的缓动:++++*曲线编辑器:每个关键帧通道变成一条可编辑曲线(这里 `position.x` 缓入、`position.y` 起伏),每个关键帧带切线手柄。*+## 用代码构建时间轴`.estimeline` 文档就是普通数据——用 `TimelineAsset` 类型加上 `TrackType` /