Minecraft 建筑生成器 是做什么的?
设计功能且建筑合理的 Minecraft 结构,涵盖任意静态方块尺度——从小巧的 1×2 家具到宏伟的城堡——通过简短的协作构思、层级化架构审查、精确的坐标锚点映射以及五步构建分层法。最终输出是一个可直接下载、自包含、零依赖的 ESM(.mjs)文件(通过文件生成工具导出,而非在聊天中转储原始代码块),该文件为 Minecraft 26.3(DataVersion: 5023)生成 gzip 压缩的原始 .nbt 结构文件,干净无运行时验证崩溃。
使用时机
- 用户要求创建、设计或生成任意静态方块 Minecraft 结构:
- **家具与道具 (T1c):**椅子、餐桌、书架、长凳、双层床、王座、柜台、台灯、武器架。
- **装饰与市政结构 (T1b):**水井、路灯、雕像、路标、桥梁、栅栏、农田、喷泉、纪念碑、凉亭。
- **简单可居住掩体 (T1a):**帐篷、篝火掩体、棚屋、单间小屋、小型瞭望塔。
- **标准建筑 (T2):**村民房屋、商店、小型寺庙、两层小屋、图书馆、面包店、灯塔、马厩。
- **复杂建筑群 (T3):**城堡、大教堂、村公所、豪宅、市集广场、带围墙的定居点。
- 用户想要一个独立的 Node.js 脚本,能够输出可在本地执行并在 Shulkr Viewer 上进行 3D 预览的原始
.nbt文件。
超出范围
本技能不处理:
- 红石逻辑(电路、活塞门、陷阱)——使用专用的红石技能。
- 地形改造(山脉、山谷、河流、自定义地形)——使用专用的地形技能。
- 方块实体状态(箱子内容物、熔炉进度、告示牌文本)——模板仅写入调色板/方块;加载后在游戏内编辑。
- 实体姿态(盔甲架、带有特定物品的物品展示框)——需要远超基础模板的实体 NBT。
- 命令方块 / 动画——非静态
.nbt结构。
如果用户请求上述任何内容,请明确说明限制并提供最接近的静态方块替代方案。
文件夹结构
minecraft-builder/
├── SKILL.md
├── registry_26_3.json
└── references/
├── architecture-principles.md (T2 & T3)
├── biome-styles.md (T2 & T3, 或与生物群系匹配的 T1)
├── room-templates.md (T2 & T3)
└── furniture-patterns.md (T1c)
构建复杂度层级
首先将每个请求分类到五个层级之一。层级决定了哪些阶段、技术规则和参考文件适用。
| 层级 | 示例 | 应用的阶段 | 重点 |
|---|---|---|---|
| T1a — 简单可居住结构 | 帐篷、篝火掩体、小棚屋、单间小屋、小型瞭望塔 | 1, 2, 3 (有条件的), 4, 5 | 入口清晰、方块接地、功能家具齐全 |
| T1b — 不可居住结构 | 水井、路灯、雕像、路标、桥梁、栅栏、农田、喷泉、纪念碑 | 1, 2, 3 (仅支撑), 4, 5 | 尺寸、功能元素(水/光/连接)、支撑完整性 |
| T1c — 家具 / 多方块物体 | 椅子、餐桌、书架单元、长凳、床架、双层床、王座、柜台 | 1, 2, 3 (人体工学), 4, 5 | 人体工学、朝向、可达性、材料连贯性 |
| T2 — 标准建筑 | 村民房屋、商店、小型寺庙、两层小屋、图书馆、面包店、灯塔 | 1, 1.5, 2, 3, 4, 5, 6 | 完整建筑与技术清单(生物群系建议) |
| T3 — 复杂建筑群 | 多建筑群、城堡、村公所、大教堂、豪宅、市集广场 | 1, 1.5, 2, 3 (+动线), 4, 5, 6 | 完整清单、严格的生物群系连贯性、明确的室内间动线 |
如果层级不明确,请询问用户:“这是家具(椅子/桌子)、装饰结构(水井/灯/雕像)、简单掩体(帐篷/棚屋)、标准建筑(房屋/商店)还是复杂建筑群(城堡/大厅)?”
工作流程
阶段 1:简要构思与澄清(当细节不明确时)
首先对建筑层级进行分类。如果关键设计参数缺失或不明确,请根据层级提出 2 到 4 个简洁、具体的问题:
对于 T1a(可居住简单结构):
- 多少住户?(决定床、座位、存储空间)
- 生物群系 / 调色板(森林营地、平原、针叶林等)
- 封闭式还是开放式?特殊功能(篝火、箱子、顶篷)?
对于 T1b(不可居住结构):
- 功能元素是什么?(水源、光源、连接点、装饰焦点)
- 目标尺寸(高 × 宽 × 深)?
- 生物群系 / 材料调色板?
- 是否需要顶部/屋顶/顶篷或支撑底座?
对于 T1c(家具):
- 家具的功能是什么?(座位、用餐、存储、睡眠、展示)
- 有多少个“座位”或容量单位?(1 把椅子、4 座餐桌、6 格书架)
- 材料调色板?(橡木、云杉木、深色橡木、诡异木等)
- 将放置在哪里?(靠墙、房间中心、室外)——影响默认朝向。
对于 T2 / T3:
- 住户与功能(谁使用它,主要用途)
- 生物群系 / 方块调色板
- 规模与特殊功能(占地面积、楼层、开放式与封闭式、烟囱/阳台/顶篷)
- 对于 T3:连接的建筑物/侧翼数量(如有)
如果用户已经指定了这些细节或明确要求立即生成,则跳过构思并直接进入下一阶段。
阶段 1.5:架构审查(仅限 T2 和 T3)
对于 T1a、T1b 和 T1c 跳过此阶段。
对于 T2 和 T3,在锁定坐标之前,请查阅 references/ 中的参考文件:
architecture-principles.md— 比例、立面深度、轮廓细节、动线、照明和材料连贯性规则。biome-styles.md— 选定生物群系的调色板和屋顶样式;如果用户未选择生物群系,请选择一个并明确说明选择。room-templates.md— 每个房间/区域的最小尺寸和所需功能方块。
在阶段 3 之前解决每一项:
- 每个房间/区域满足其功能的最小尺寸(来自
room-templates.md)。 - 每 4×4 室内区域至少有一个光源(来自
architecture-principles.md)。 - 屋顶样式与选定生物群系匹配,并包含 1 方块的悬挑(来自
biome-styles.md和architecture-principles.md)。 - 材料调色板 ≤ 3 种主色 + 1 种强调色,并具有垂直渐变(石材/重型底座、木材/主要墙体)。
- 立面深度与轮廓:转角框架柱(
原木)+ ≥ 2 个轮廓/装饰细节(外部烟囱、活板门百叶窗、门廊/阳台、老虎窗、藤蔓)。 - 模拟人生导航标准:门和栅栏门前后有清晰的 1 方块走道区域,楼梯和梯子的室内底部/顶部平台,床旁边(加上上方 2 方块空气),箱子和工作台/座位前面,90° 走廊拐角处,以及任何阳台/甲板栏杆内侧 ≥ 1 方块的可行走地板行(总深度 ≥ 2 方块)。
- 建筑比例不是 1:1:1(变化宽度、深度和高度)。
- 动线:每个房间均可通过 ≥ 1 方块宽(主要路径 ≥ 2 方块)的路径从入口到达。
阶段 2:方块注册表查询 (registry_26_3.json)
- 检查技能目录中的
registry_26_3.json,以验证 Minecraft 26.3(DataVersion: 5023)的确切方块 ID(minecraft:<名称>)和有效的方块状态属性,尤其是对于较新的方块(铜变种、苍白橡木、树脂、凝灰岩砖等)。 - 切勿猜测方块状态属性名称或允许的枚举值。
- 如果请求的方块或属性在注册表中缺失,请向用户指出差距,并提出最接近的有效替代方案,而不是默默地发明 ID。
阶段 3:坐标锚点表与技术构建规则
不要绘制 ASCII 字符网格。 在编写代码之前,定义一个精确的坐标锚点表(X, Y, Z),以便每个方块放置与 setBlock()/fill() 调用一一对应:
- 边界框与标高基准:
- 声明
SIZE = [W, H, L](X: 0..W-1,Y: 0..H-1,Z: 0..L-1)。 - 固定精确标高:
Y_base(地基/支柱)、Y_floor1(一层)、Y_floor2(上层,如有)、Y_roof_start和Y_roof_peak。
- 声明
- 锚点坐标表: 列出精确坐标和朝向方向:
- 外部壳体与框架柱: 角柱
(X, Z)坐标和墙体边界。 - 室内地板边界(
X_min..X_max,Z_min..Z_max): 明确验证每个室内床、箱子、桌子和工作台坐标严格位于室内地板边界内(X_wall_west + 1 .. X_wall_east - 1,Z_wall_north + 1 .. Z_wall_south - 1),且绝不与外部或隔墙坐标重叠。 - 门 / 入口:
(X, Y_floor, Z)+facing+hinge+ 清晰的前后瓷砖。 - 楼梯: 室内底部入口平台
(X0, Y1, Z0)→ 第一级台阶(X1, Y1, Z1)→ (如果转弯:转弯平台(Xt, Y_turn, Zt))→ 顶部台阶(X2, Y2-1, Z2)→ 室内顶部出口平台(X3, Y2, Z3)+facing。 - 阳台 / 门廊(如有): 可行走地板边界与外侧栏杆坐标(确保栏杆内侧 ≥ 1 方块可行走行)。
- 烟囱 / 实用竖井: 主要屋顶坡度外的外部
(X, Z)立柱,带四面顶部检查。 - 关键室内 / 功能元素: 床、楼梯椅/沙发(带靠背方向,明确
shape: 'straight')、工作台、存储空间、水/光核心以及带(X, Y, Z)坐标的家具。
- 外部壳体与框架柱: 角柱
技术细节规则(通过设计 & 图层顺序强制执行 — 无运行时抛出验证器)
在编写构建脚本时直接应用这些技术构建规则:
通用规则(所有层级):
- Minecraft 楼梯-座位朝向与显式形状锁定规则: 在 Minecraft 中,
minecraft:*_stairs的facing指向高靠背侧(上升台阶),而非低位座位侧。- 每当使用楼梯作为椅子、沙发或可行走楼梯台阶时,始终显式传递
shape: 'straight'(对于转角沙发/对角楼梯使用outer_*/inner_*),以便autoConnectStairs()永远不会意外地将椅子或楼梯台阶在放置于同一Y的相邻楼梯旁时突变为转角屋顶方块。 - 仅在屋顶楼梯上省略
shape(设为undefined),以便它们自动连接成屋脊/斜脊。 - 对于低矮咖啡桌,使用
bottom台阶(type: 'bottom'),使它们与地板齐平而不悬空。
- 每当使用楼梯作为椅子、沙发或可行走楼梯台阶时,始终显式传递
- 自动连接屋顶、转角与单方块转角楼梯 (
autoConnectStairs()): 每当使用*_stairs构建斜顶、四坡顶或锥形屋顶时,autoConnectStairs()在阶段 5 结束时运行,使用原版 Minecraft 锁检查规则:- 任何具有显式
shape(outer_left、outer_right、inner_left、inner_right或straight——例如楼梯椅、可行走楼梯台阶、独立单方块转角楼梯或对角楼梯)的楼梯将保持不变,除非shape被省略(undefined)。 - 当
shape被省略时,autoConnectStairs()检查同一half的正交邻居:它从正前方(+facing)的垂直楼梯形成outer_left/outer_right,仅当相反侧面未被平行楼梯锁定(facing === f)时;并从正后方(-facing)的垂直楼梯形成inner_left/inner_right,仅当匹配侧面未被平行楼梯锁定(facing === f)时。
- 任何具有显式
- 双箱子朝向与自动配对 (
connectDoubleChests()): 在 Minecraft 中,箱子的type(single、left、right)从箱子自身的视角(看向其facing方向)定义,而非从查看者的视角定义:- 当站在双箱子前面看向其锁扣时:查看者左侧的方块是
type: 'right'(位于箱子的右侧:rightOf[facing]),查看者右侧的方块是type: 'left'(位于箱子的左侧:leftOf[facing])。 - 始终在阶段 5 结束时运行
connectDoubleChests(),以便拥有相同facing的相邻匹配minecraft:chest或minecraft:trapped_chest方块自动配对成有效的type: 'right'+type: 'left'半部,而不会出现纹理反转(除非显式指定了type: 'single')。切勿在单行中放置 3 个相同类型的箱子。
- 当站在双箱子前面看向其锁扣时:查看者左侧的方块是
- 自动配对的雙开门 (
autoPairDoubleDoors()): 当两个匹配的*_door方块并排放置,共享相同的facing和Y时,autoPairDoubleDoors()在阶段 5 结束时运行,以在lower和upper两半部上分配对称的铰链(从查看者的正面视角,左门为hinge: 'left',右门为hinge: 'right'),使把手在中心整洁地对接。 - 自动连接的栅栏、墙、栅栏门和玻璃板 (
connectFencesAndPanes()&connectWalls()):connectFencesAndPanes()为*_fence、*_pane和iron_bars计算north/south/east/west布尔属性,通过isFullSolidForConnection()排除非实体和非连接方块(*_glass、*_leaves、hopper、bell、beacon、glowstone、台阶、楼梯、门等)。connectWalls()为所有*_wall方块计算north/south/east/west枚举状态('none'、'low'或当实体方块直接位于连接上方时的'tall')以及中心柱up('true'/'false'),并自动将任何两侧为*_wall方块的*_fence_gate的in_wall设置为'true',以便栅栏门与墙面齐平降低。
- 配对的床辅助函数 (
placeBed(x, y, z, color, facing)): 始终放置床
[truncated for translation]