Community编程与开发github.com

Minecraft 建筑生成器

从单个家具到庞大城堡,为 Minecraft 设计、规划并生成任意静态方块结构,并提供可直接下载的独立 Node.js 脚本。

Minecraft 建筑生成器 是什么?

Minecraft Builder 是一款 AI 智能体技能,专注于为 Minecraft 26.3(DataVersion 5023)设计并生成静态方块结构。它涵盖了从 T1a 级别的简单可居住结构(如帐篷、小屋)到 T3 级别的复杂建筑群(如城堡、大教堂)的完整层级体系。该技能通过协作构思、层级化架构审查、精确的坐标锚点映射以及五步构建分层法来确保结构的功能性和建筑合理性。最终输出是一个自包含、零依赖的 ESM(.mjs)文件,该文件可在本地运行,生成 gzip 压缩的原始 .nbt 文件,并可在 Shulkr Viewer 等工具中进行 3D 预览。该技能不处理红石、地形改造或实体状态等动态元素。

兼容平台✓Claude Code~Codex CLI~Cursor
Part ofMobile
npx skills add https://github.com/marvaproject/minecraft-structure-builder/tree/HEAD/minecraft-builder

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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(可居住简单结构):

  1. 多少住户?(决定床、座位、存储空间)
  2. 生物群系 / 调色板(森林营地、平原、针叶林等)
  3. 封闭式还是开放式?特殊功能(篝火、箱子、顶篷)?

对于 T1b(不可居住结构):

  1. 功能元素是什么?(水源、光源、连接点、装饰焦点)
  2. 目标尺寸(高 × 宽 × 深)?
  3. 生物群系 / 材料调色板?
  4. 是否需要顶部/屋顶/顶篷或支撑底座?

对于 T1c(家具):

  1. 家具的功能是什么?(座位、用餐、存储、睡眠、展示)
  2. 有多少个“座位”或容量单位?(1 把椅子、4 座餐桌、6 格书架)
  3. 材料调色板?(橡木、云杉木、深色橡木、诡异木等)
  4. 将放置在哪里?(靠墙、房间中心、室外)——影响默认朝向。

对于 T2 / T3:

  1. 住户与功能(谁使用它,主要用途)
  2. 生物群系 / 方块调色板
  3. 规模与特殊功能(占地面积、楼层、开放式与封闭式、烟囱/阳台/顶篷)
  4. 对于 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() 调用一一对应:

  1. 边界框与标高基准:
    • 声明 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。
  2. 锚点坐标表: 列出精确坐标和朝向方向:
    • 外部壳体与框架柱: 角柱 (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]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能