SuperAPI AI 工具集

tinyworld-ghost-world-gen

通用与其它

查看项目

更新于 10-30 12:08

技能介绍

用途

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) 不受生成器影响。