AncTe/template
1
0
Fork 0
mirror of https://github.com/motajs/template.git synced 2026-10-18 12:40:18 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs(10-10): 引导式重写 hero-location、map-structure

Browse Source
This commit is contained in:
unanmed 2026-10-17 21:23:14 +08:00
parent b4d1202a74
commit 3836afe5d9
2 changed files with 10 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/intermediate/hero-location.md
View File

@ -1,9 +1,11 @@
# 勇士位置
勇士位置（`state.hero.location`）记录当前坐标、朝向与所在楼层。本篇只讲如何**获取**这些信息。
很多逻辑都要先知道一件事：勇士此刻站在哪一层、哪一格、朝哪个方向。比如「进门前朝向对不对」「这只怪离勇士多远」「当前在哪一层」。勇士位置（`state.hero.location`）记录的就是这些信息。本篇只讲如何**获取**它们；如何移动、如何切换楼层属于更底层的内容，留到高级教程。
## 当前坐标
勇士站在哪一格，读 `x`、`y` 即可：
```ts
const x = state.hero.location.x;
const y = state.hero.location.y;
@ -19,7 +21,7 @@ const y = state.hero.location.y;
const dir = state.hero.location.getCurrentFaceDirection();
```
`state.hero.getLocation()` 会返回一个包含 `x`、`y`、`direction` 的位置对象（`IFacedTileLocator`），适合一次性取走当前坐标与朝向：
如果坐标和朝向要一起用，`state.hero.getLocation()` 会返回一个包含 `x`、`y`、`direction` 的位置对象（`IFacedTileLocator`），一次取走更省事：
```ts
const loc = state.hero.getLocation();

8
docs/intermediate/map-structure.md
View File

@ -1,6 +1,10 @@
# 地图结构
地图在数据端分成三层：**楼层集合**（`state.maps`）、**楼层**（`IGameMap`）与**图层**（`IMapLayer`）。本篇说明这三层的关系与常用接口。
地图并不是一张铺开的大图，而是分层的。要从代码里找到「某一层的某一块图块」，得先顺着它的层次往下走。地图在数据端分成三层：**楼层集合**（`state.maps`）、**楼层**（`IGameMap`）与**图层**（`IMapLayer`）。本篇说明这三层的关系与常用接口。
## 三层结构
可以把三层想成一棵树：`state.maps` 是「所有楼层的总目录」，里面每个条目是一个楼层；每个楼层里又有一组图层，图块就摆在图层上。日常查地图，大多是从第一层往下逐级找。
## 楼层集合（IMapState）
@ -22,7 +26,7 @@ for (const [id, map] of state.maps.iterateAllMaps()) {
## 楼层激活（active）
每个楼层（`IGameMap`）都有 `active` 表示是否激活。**只有已激活的楼层才会进入存档**——`IMapState` 的存档仅包含已激活楼层。`getActiveMap(id)` 只返回已激活的楼层，迭代可用 `iterateActiveMaps()` / `iterateInactiveMaps()`。
每个楼层（`IGameMap`）都有 `active` 表示是否激活。**只有已激活的楼层才会进入存档**——`IMapState` 的存档仅包含已激活楼层。因此如果一处楼层改动要跟着存档走，记得先把它激活。`getActiveMap(id)` 只返回已激活的楼层，迭代可用 `iterateActiveMaps()` / `iterateInactiveMaps()`。
```ts
state.maps.setMapActiveStatus('floor-1', true);