用途
tinyworld-ghost-world-gen 用于说明 tiny-world-builder 中幽灵地图的生成规则,主要面向需要修改 makeGhostWorld(boardX, boardZ) 行为、路径/道路/河流连续性、确定性重生成或边缘连接的场景。makeGhostWorld(boardX, boardZ) 生成单个不可编辑幽灵地块的内容。
主要能力与规则
确定性
相同 (boardX, boardZ) 始终产出相同格子;结果缓存于 ghostBoardCells,键为 'bx,bz'。移开再移回必须生成一致内容。
种子随机数
ghostHash(a, b, salt) 是用于地块级决策的 32 位 mulberry 风格混合函数。单格随机通过 cellRand(x, z, salt),但必须使用全局坐标 (boardX * GRID + x, boardZ * GRID + z, salt),不能使用局部坐标。
连接规则
水平路径 Z 仅由 boardZ 决定(pathZForRow(boardZ));垂直路径 X 仅由 boardX 决定(pathXForCol(boardX));水平与垂直路径在同一地块内相交时自然形成十字路口。河流通过 riverXForCol(boardX) 按列共享,若与垂直路径冲突则偏移一列。河流与水平路径交叉处放置 kind: 'bridge' 瓦片。密度参考:约 30% 世界行无水平路径,约 35% 世界列无垂直路径,约 88% 世界列无河流(约 12% 有)。
跨地块相邻
ghostCellAt(boardX, boardZ, x, z) 可解析任意局部坐标;越界时进入相邻地块获取 makeGhostWorld(...) 结果,若回绕到 (0, 0) 则读取 home world[][]。getGhostNeighbors 和 getGhostTerrainNeighbors 基于 ghostCellAt 实现边缘邻接。
格子结构与空白地块
格子结构必须与主地块一致:{ terrain, kind, floors, buildingType, fenceSide, extras }。Generate 对话框可设置 ghostBoardsBlank = true,使非主地块返回确定性空白草地格子。
用户覆盖与持久化
用户在幽灵地块上的建造/擦除为覆盖,存储于 world[gx][gz] 全局坐标。applyToolToCell 将生成格复制到 world,移除幽灵网格,再通过 applyTool/setCell 渲染主格子网格。ghostCellAt 优先读取 world[gx][gz];buildGhostBoard 跳过 world[][] 中已存在的全局坐标。saveState 遍历 Object.keys(world) 序列化所有已填充格子;applyState 恢复主格子和非主地块覆盖,幽灵地块在其周围确定性重新生成。
限制与注意事项
路径和河流不能同时依赖 boardX 和 boardZ;装饰不能用局部坐标做种子;除 makeGhostWorld 外不得修改 ghostBoardCells。验证方式包括:向东平移多个地块检查路径连续、移出预加载范围再返回检查内容一致、检查河流跨路径处渲染桥梁、确认主地块 (0, 0) 不受生成器影响。