Minecraft Builder 是做什麼的?
設計功能且結構合理的 Minecraft 建築,範圍涵蓋任何靜態方塊式規模——從 1×2 的小型家具到宏偉的城堡——透過簡短的協作腦力激盪、分級建築審查、精確的座標錨定映射以及5 階段結構分層。最終輸出為一個可下載、自包含、無外部相依性的 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:
- 居住者與功能(誰使用它、主要用途)
- 生態域 / 方塊調色盤
- 規模與特殊功能(占地面積、樓層數、露天 vs 封閉、煙囪/陽台/遮篷)
- 針對 T3:連接的建築物/側翼數量(如果有的話)
如果使用者已指定這些細節,或明確要求立即生成,則跳過腦力激盪並直接進入下一階段。
階段 1.5:建築審查(僅 T2 與 T3)
跳過此階段對於 T1a、T1b 和 T1c。
針對 T2 & T3,在鎖定座標之前,請查閱 references/ 中的參考檔案:
architecture-principles.md—— 比例、立面深度、輪廓細節、動線、照明和材質一致性規則。biome-styles.md—— 所選生態域的調色盤和屋頂風格;如果使用者未選擇生態域,請選擇一個並明確說明選擇。room-templates.md—— 每個房間/區域的最小房間尺寸和所需的功能性方塊。
在階段 3 之前解決所有項目:
- [ ] 每個房間/區域滿足其功能的 minimum dimensions(來自
room-templates.md)。 - [ ] 每 4×4 室內區域至少一個光源(來自
architecture-principles.md)。 - [ ] 屋頂風格符合所選生態域,並包含 1 個方塊的懸挑(來自
biome-styles.md&architecture-principles.md)。 - [ ] 材質調色盤 ≤ 3 種主要 + 1 種強調色,並有垂直漸變(石頭/重型底座、木材/主要牆面)。
- [ ] 立面深度與輪廓:角落框架柱(
log)+ ≥ 2 個輪廓/裝飾細節(外部煙囪、地板門百葉窗、門廊/陽台、老虎窗、藤蔓)。 - [ ] 模擬市民導航標準: 在門和柵欄門的前/後、樓梯和梯子的室內底部/頂部平台、床邊(加上上方 2 格空氣)、箱子/工作台/座位前、90° 走廊轉角處,以及任何陽台/甲板欄杆內部(總深度 ≥ 2 格)確保有清晰 1 格寬的可行走區域。
- [ ] 建築比例不是 1:1:1(變化寬度、深度和高度)。
- [ ] 動線:每個房間均可透過 ≥ 1 格寬的路徑(主要路徑 ≥ 2 格)從入口到達。
階段 2:方塊註冊表查詢 (registry_26_3.json)
- 檢查技能目錄中的
registry_26_3.json以驗證確切的方塊 ID (minecraft:<name>) 和 Minecraft 26.3 (DataVersion: 5023) 有效的方塊狀態屬性,特別是對於較新的方塊(銅變種、蒼白橡木、樹脂、凝灰岩磚等)。 - 切勿猜測方塊狀態屬性名稱或允許的枚舉值。
- 如果要求的方塊或屬性在註冊表中缺失,請向使用者說明差距,並提議最接近的有效替代方案,而不是默默發明 ID。
階段 3:座標錨定表與技術構建規則
請勿繪製 ASCII 字元網格。 在編寫程式碼之前,定義一個精確的座標錨定表 (X, Y, Z),使每個方塊放置都能 1:1 對應到 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。 - 陽台 / 門廊(如果有的話): 可行走地板邊界 vs 外部欄杆座標(確保欄杆內側至少有 1 格可行走方塊行)。
- 煙囪 / 公用設施豎井: 主屋頂坡度外的外部
(X, Z)柱,需進行 4 面頂蓋檢查。 - 關鍵內部 / 功能性元素: 床、樓梯-椅子/沙發(帶有靠背方向,明確的
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——例如樓梯-椅子、可行走的樓梯階梯、獨立的 1 方塊轉角樓梯或對角線樓梯)的樓梯將保持原樣不變,除非shape被省略(undefined)。 - 當
shape被省略時,autoConnectStairs()會在同一half檢查正交相鄰方塊:如果在正前方(+facing)有一個垂直樓梯,且對側未被平行樓梯鎖定(facing === f),則形成outer_left/outer_right;如果在正後方(-facing)有一個垂直樓梯,且匹配側未被平行樓梯鎖定(facing === f),則形成inner_left/inner_right。
- 任何帶有明確
- 雙箱方向與自動配對 (
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布林屬性,排除非固體和非連接方塊(*_glass、*_leaves、hopper、bell、beacon、glowstone、半磚、樓梯、門等)透過isFullSolidForConnection()。connectWalls()計算所有*_wall方塊的north/south/east/west枚舉狀態('none'、'low'或'tall',當一個固體方塊直接位於連接上方時)以及中心柱up('true'/'false'),並自動將被*_wall方塊夾擊的任何*_fence_gate設置為in_wall: 'true',使閘門與牆壁齊平降低。
- 配對床輔助函數 (
placeBed(x, y, z, color, facing)): 始終將床放在...
[原文因長度限制而被截斷,但翻譯應保留所有後續的 markdown 結構、程式碼、指令和規則,直到原文結束。]
階段 4:建構腳本檔案生成
此階段產生最終的 .mjs 檔案。
[持續翻譯後的完整 SKILL.md 內容...]