设计工具是面向建筑师以及地图 · 插件策划者的窗口。通过五个选项卡，可以统计材料清单、进行标记检查并生成规划表、查看世界地图、测量地点之间的移动距离、查看楼层剖面。
| 菜单 | 打开的选项卡 |
|---|
| 工具 › 设计工具 (材料清单·规划表·地图·移动距离·楼层视图)… | 整个窗口 |
| 工具 › 材料清单 (BOM) — 选区 | 「材料清单」+ 立即统计 |
| 工具 › 设计检查报告 | 「检查·策划表」+ 立即检查 |
| 工具 › 世界地图 (概览·密度) | 「地图」+ 立即绘制 |
| 工具 › 关闭楼层视图 | 只关闭楼层视图。 |
按 Esc 关闭窗口。控制台命令 bom · design_report · slice 也执行同样的操作。
- 选择要建造的建筑。
- 点击 工具 › 材料清单 (BOM) — 选区。
- 会显示按分类的物品数量 · 组数 · 潜影盒数量。
- 开启「估算原材料」后，会一直分解到原木 · 圆石 · 沙子等原材料进行统计。
- 用「复制 Markdown」粘贴到 Discord · Notion，或用「保存 CSV…」生成 Excel 文件。
| 字段 | 含义 |
|---|
| 范围 | 选区 · 所选 Actor (大纲) · 整个世界 |
| 「统计」 | 将方块状态转换为物品数量进行统计。 |
| 估算原材料 | 按工作台 · 切石机 · 熔炉的比例彻底分解后的原材料数量。 |
| 表 | 分类 · 物品 · 数量 · 组数 · 方块格数 |
| 「保存 CSV…」 | 可直接在 Excel 中打开的 CSV（UTF-8 BOM）。 |
| 「保存 Markdown…」·「复制 Markdown」 | Markdown 文件 · 剪贴板 |
转换为物品的规则示例如下。
| 方块 | 计数方式 |
|---|
| 门的上半 · 高花的上半 · 床头 | 0（由下半计 1 个） |
| 双层台阶 | 2 |
| 蜡烛 · 海泡菜 · 雪层 | 所含数量 |
| 墙上的火把 · 墙上的告示牌 · 墙上的旗帜 · 墙上的头颅 | 手持时的物品 |
| 作物 | 种子 |
| 花盆 | 花盆 + 植物 |
| 水 · 熔岩源 | 桶 |
| 屏障 · 基岩等 | 显示「生存不可得」 |
- 组数以 64 个（可投掷物 16 个 · 不可堆叠物 1 个）为基准。
- 自定义模型道具另以「道具」行统计。
- 原材料为估算值。不计入燃料 · 工具 · 交易 · 随机掉落。
| 字段 | 含义 |
|---|
| 「检查」 | 标记检查 + 区域重叠 · 安全区生成点 · 传送点连接 · 放置 · 命名规则 |
| 命名规则 | 开启 snake_case · 类型前缀（npc_ · town_ · warp_ …）· 自动编号 id 检查。 |
| 方块放置 (埋没·悬空) | 查找被方块埋住 · 头顶被遮挡 · 悬在空中的点标记。 |
| 视图 | 全部 · 错误·警告 · 仅错误 |
| 「修正命名 (n)」 | 一次性改为建议的 id。传送点 target 也会随之更改。用一次 Ctrl+Z 撤销。 |
检查可发现的问题示例如下。
| 发现的问题 | 级别 |
|---|
| 相同优先级的区域彼此重叠 | 警告 |
| 安全区内的生物生成点 | 错误 |
| 城镇内的生物生成点 · 狩猎场 · 地牢 · 野外以外的生物生成点 · 过于密集的生成点 | 警告 |
| 没有等级范围的狩猎场 · 地牢，没有生物生成点的狩猎场 · 地牢 | 警告 |
| 没有 BGM 的城镇 · 地牢 | 信息 |
| 未与其他传送点连接的传送点 · 单向传送点 | 信息 |
| 不属于任何区域的点标记 | 信息 |
| 安全区 · 城镇以外的玩家出生点 | 警告 |
| 被方块埋住的点标记 | 错误 |
| 头顶被遮挡 · 悬在空中的点标记 | 警告 |
双击行后，相机会移到该标记并选中它。
| 保存按钮 | 内容 |
|---|
| 规划表：「CSV…」 | 所有标记的一张表 — 类型 · id · 名称 · 引用 · 编辑器/服务器坐标 · 区域属性 · 标签 |
| 规划表：「Markdown…」 | 按类型的表 + 按区域的内容（NPC · 任务 · 生成点 · 生物数量 · 道具数量）+ Actor |
| 「Actor CSV…」 | Actor 列表 |
| 报告：「Markdown…」·「CSV…」 | 检查结果 |
| 「全部保存到文件夹」 | 在世界文件旁一次性保存规划表 · 报告 · 材料清单（世界）· 移动距离。 |
| 字段 | 含义 |
|---|
| 「重新绘制」 | 绘制俯视的高度图。大型世界需要几秒钟。 |
| 叠加显示 | 区域 · 生物生成区域 · 点标记 · 传送点连接线 |
| 密度热力图 | 关 · 全部 · NPC · 生物 · 任务 · 传送点 · 道具 |
| 网格 (格) | 统计密度的格子大小。 |
| 分辨率 (px) | 长边的像素数。越大越精细，但越慢。 |
| 「保存 PNG…」 | 将地图保存为图像。 |
- 颜色：黄 城镇 · 橙 狩猎场 · 紫 地牢 · 绿 安全区 · 天蓝 野外 · 红 生物生成点 · 青绿线 传送点。
- 单击地图，相机会移到该处。如果在点标记附近，则选中该标记。
- 鼠标悬停时显示坐标 · 区域 · 网格值。还会显示最密集的 5 处。
| 字段 | 含义 |
|---|
| 「计算」·「停止」 | 计算传送点 · 玩家出生点 · 城镇中心之间的距离。在后台运行。 |
| 步行路线 (慢) | 通过可移动性检查查找实际步行路线。 |
| 城镇中心 · 所有区域中心 | 纳入计算的区域。 |
| 远距离阈值 (秒) | 耗时超过该时间时标记为「较远」。 |
| 表 | 起点 · 终点 · 直线 · 路径 · 步行 · 疾跑 · 状态 · 备注 |
| 「保存 CSV…」·「保存 Markdown…」 | 保存结果 |
- 以步行 4.317 格/秒、疾跑 5.612 格/秒计算时间。
- 状态为「绕路 ×n」（路径比直线长得多）·「较远」·「无法到达」·「由传送点连接」。
- 双击行后，相机会移到起点。
- 步行路线在包围各点的范围 + 32 格（每边最多 768 格）内查找。超出时只计算直线距离。
从画面上去掉指定高度以上（或以下）的部分，以查看室内。方块本身不变，因此不影响保存和导出。
| 字段 | 含义 |
|---|
| 切除上方: y ≤ | 只显示到此高度。用 +1 · −1 · +4 · −4 按钮移动（一层 ≈ 4~5 格）。 |
| 切除下方: y ≥ | 从此高度开始显示。 |
| 「设为选择框高度」 | 只显示选择框下沿 · 上沿之间的高度。 |
| 「关闭」 | 关闭楼层视图（与 工具 › 关闭楼层视图 相同）。 |
- 被切除的方块单击时也会穿透。
- 楼层视图与 H 隐藏分开运作。
- 道具 · 标记的显示不会被切除。
| 设置 | 选项卡 | 默认 |
|---|
| 范围 | 材料清单 | 从工具菜单打开时，有选择则为选区，没有则为整个世界 |
| 命名规则 · 方块放置 (埋没·悬空) | 检查·策划表 | 开 |
| 步行路线 (慢) · 城镇中心 · 所有区域中心 | 移动距离 | 开 · 开 · 关 |
| 键 | 动作 |
|---|
| Esc | 关闭设计工具窗口 |
| Ctrl+Z | 撤销「修正命名」 |
| 在表中双击 | 将相机移到该标记 · 起点 |
- 「全部保存到文件夹」需要先保存世界。已有同名文件时会附加
_v2。
- 计算过程中修改世界后，会重新计算移动距离。
- 命名规则前缀为固定的默认值。目前还没有按项目更改的设置。
- 同样的计算也可以通过 AI 连接的
bom · design_report · travel_times 工具完成（MCP 工具列表）。