Communityコーディング&開発github.com

Minecraft Builder

アイデア出し、設計、そしてあらゆる静的ブロックベースのMinecraft構造物を生成します。家具から複合施設まで、座標アンカーテーブルと5パス構築レイヤリングを使用し、ダウンロード可能なNode.js生成ファイルを出力します。

Minecraft Builder とは?

このスキルは、Minecraft(バージョン26.3 / DataVersion 5023)向けのあらゆる静的ブロック構造物を設計・生成するための包括的なガイドです。家具(T1c)、装飾・公共建造物(T1b)、簡易シェルター(T1a)、標準的な建物(T2)、複合施設(T3)の5段階の複雑度レベルに分類し、それぞれに応じた設計フェーズと技術ルールを適用します。ワークフローは、ブレインストーミング、アーキテクチャレビュー(T2/T3のみ)、ブロックレジストリの参照、座標アンカーテーブルの定義、そして5パス構築レイヤリングで構成され、最終的に自己完結型のNode.jsスクリプト(.mjsファイル)を生成します。このスクリプトは、3Dプレビューやゲーム内での読み込みに使用できるバニラの.nbtファイルを出力します。主な機能として、階段の向きや結合ルール、ダブルチェストの自動ペアリング、両開きドアの自動調整、フェンスや壁の自動接続など、Minecraftのブロック状態を正確に反映した技術的詳細ルールが組み込まれています。

対応✓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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Minecraft Builder は何をしますか?

あらゆる静的ブロックベースの規模(1×2の小さな家具から広大な城まで)で、機能的かつ建築的に堅牢なMinecraft構造物を設計します。短い協力的なブレインストーミング、段階的な建築レビュー、正確な座標アンカーマッピング、そして5パス構築レイヤリングを通じて実現します。最終出力は、チャットに生のコードブロックをダンプするのではなく、ファイル生成ツールを介してエクスポートされるダウンロード可能な自己完結型、依存関係のないESM(.mjs)ファイルです。このファイルは、Minecraft 26.3(DataVersion: 5023)用のgzip圧縮されたバニラ.nbt構造ファイルを、実行時の検証クラッシュなしにクリーンに生成します。

使用タイミング

  • ユーザーがあらゆる静的ブロックベースのMinecraft構造物の作成、設計、または生成を依頼した場合:
    • 家具&小道具 (T1c): 椅子、ダイニングテーブル、本棚、ベンチ、二段ベッド、玉座、カウンター、ランプ、武器ラック。
    • 装飾&公共建造物 (T1b): 井戸、街灯、像、標識、橋、フェンス、農場区画、噴水、記念碑、ガゼボ。
    • 簡易居住可能シェルター (T1a): テント、キャンプファイアシェルター、小屋、ワンルームの掘っ立て小屋、小さな見張り塔。
    • 標準的な建物 (T2): 村人の家、店、小さな寺院、2階建てコテージ、図書館、パン屋、灯台、厩舎。
    • 複合施設 (T3): 城、大聖堂、村役場、邸宅、市場広場、壁で囲まれた集落。
  • ユーザーが、ローカルで実行可能でShulkr Viewerで3Dプレビュー可能なバニラ.nbtファイルを出力するスタンドアロンのNode.jsスクリプトを希望する場合。

対象外

このスキルは以下を扱いません:

  • レッドストーンロジック(回路、ピストンドア、トラップ) — 専用のレッドストーンスキルを使用してください。
  • 地形形成(山、谷、川、カスタム地形) — 専用の地形スキルを使用してください。
  • ブロックエンティティの状態(チェストの中身、かまどの進行状況、看板の文字) — テンプレートはパレット/ブロックのみを書き込みます。これらはゲーム内でロード後に編集してください。
  • エンティティのポージング(特定のアイテムを持つアーマースタンドや額縁) — 基本テンプレートをはるかに超えるエンティティ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)

建造複雑度の階層

まずすべてのリクエストを5つの階層のいずれかに分類します。階層によって、適用するフェーズ、技術ルール、参照ファイルが決まります。

階層例適用フェーズ重点項目
T1a — 簡易居住可能テント、キャンプファイアシェルター、小さな小屋、ワンルームの掘っ立て小屋、小さな見張り塔1, 2, 3 (条件付き), 4, 5入口の明確化、接地ブロック、機能的な家具の存在
T1b — 非居住可能構造物井戸、街灯、像、標識、橋、フェンス、農場区画、噴水、記念碑1, 2, 3 (支持のみ), 4, 5寸法、機能要素(水/光/接続)、支持構造の完全性
T1c — 家具/複数ブロックオブジェクト椅子、ダイニングテーブル、本棚ユニット、ベンチ、ベッドフレーム、二段ベッド、玉座、カウンター1, 2, 3 (人間工学), 4, 5人間工学、向き、アクセシビリティ、材料の一貫性
T2 — 標準的な建物村人の家、店、小さな寺院、2階建てコテージ、図書館、パン屋、灯台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 — 選択されたバイオームのパレットと屋根スタイル。ユーザーがバイオームを選択しなかった場合は、1つを選択してその選択を明示的に述べてください。
  • room-templates.md — 部屋/ゾーンごとの最小部屋サイズと必要な機能ブロック。

フェーズ 3 の前にすべての項目を解決してください:

  • すべての部屋/ゾーンが、その機能の最小寸法を満たしている(room-templates.md より)。
  • 屋内エリア 4×4 ごとに少なくとも 1 つの光源がある(architecture-principles.md より)。
  • 屋根スタイルが選択されたバイオームに一致し、1ブロックの張り出しを含む(biome-styles.md & architecture-principles.md より)。
  • 素材パレットは 3 メイン + 1 アクセント以内で、垂直方向のグラデーションがある(石/重い基礎、木材/主壁)。
  • ファサードの奥行きとシルエット:コーナーフレーミング柱(log)+ 2つ以上のシルエット/トリムの詳細(外部煙突、トラップドアの雨戸、ポーチ/バルコニー、ドーマー、ツタ)。
  • シムズナビゲーション基準: ドアとフェンスゲートの前後、階段とハシゴの室内下/上階踊り場、ベッドの横(さらにその上の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:<name>)と有効なブロック状態プロパティを確認します。特に新しいブロック(銅の亜種、ポールオーク、レジン、タフレンガなど)については注意してください。
  • ブロック状態のプロパティ名や許可された列挙値は決して推測しないでください。
  • リクエストされたブロックやプロパティがレジストリにない場合は、そのギャップをユーザーに伝え、最も近い有効な代替案を提案してください。IDを黙って発明しないでください。

フェーズ 3: 座標アンカーテーブルと技術的構築ルール

ASCII文字グリッドを描画しないでください。 コードを書く前に、すべてのブロック配置が setBlock() / fill() 呼び出しに1対1でマッピングされるように、正確な座標アンカーテーブル(X, Y, Z)を定義してください:

  1. 境界ボックスと標高データム:
    • SIZE = [W, H, L](X: 0..W-1、Y: 0..H-1、Z: 0..L-1)を宣言します。
    • 正確な標高レベルを固定します:Y_base(基礎/高床)、Y_floor1(1階)、Y_floor2(2階、ある場合)、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) 柱、4面のキャップチェック付き。
    • 主要な内部/機能要素: ベッド、階段椅子/ソファ(背もたれの向きと明示的な shape: 'straight' 付き)、作業台、収納、水/光コア、および (X, Y, Z) 座標を持つ家具。

技術的詳細ルール(設計とレイヤー順序により適用 — ランタイムスローバリデーターなし)

これらの技術的構築ルールを、ビルドスクリプトの作成中に直接適用します:

ユニバーサルルール(全階層):

  • Minecraft 階段座席の向きと明示的な形状固定ルール: Minecraft では、minecraft:*_stairs の facing は高い背もたれ側(上りの段)を指し、低い座面側を指しません。
    • 階段を椅子、ソファ、または歩行可能な階段の段として使用する場合は常に、明示的に shape: 'static' を渡してください(コーナーソファ/斜め階段の場合は outer_*/inner_*)。これにより、autoConnectStairs() が、同じ Y にある別の階段に隣接して配置された場合に、椅子や階段の段を誤ってコーナー屋根ブロックに変更することを防ぎます。
    • 自動的に寄棟/谷に結合されるべき屋根の階段でのみ、shape を省略(undefined)したままにしてください。
    • ローテーブルには、bottom のハーフブロック(type: 'bottom')を使用して、床にぴったりと設置され、浮かないようにします。
  • 自動接続屋根、コーナー&単一ブロックコーナー階段 (autoConnectStairs()): *_stairs を使用して傾斜、寄棟、またはピラミッド型の屋根を構築する場合は常に、フェーズ 5 の最後に autoConnectStairs() が実行され、バニラ Minecraft のロックチェックルール を使用します。
    • 明示的な shape(outer_left、outer_right、inner_left、inner_right、または straight — 例:階段椅子、歩行可能な階段の段、スタンドアロンの1ブロックコーナー階段、斜め階段)を指定して配置された階段は、shape が省略(undefined)されていない限り、そのまま保存されます。
    • shape が省略された場合、autoConnectStairs() は同じ half の直交する隣接ブロックをチェックします:反対側の側面が平行な階段(facing === f)によってロックされていない場合にのみ、前方(+facing)の垂直な階段から outer_left/outer_right を形成し、一致する側面が平行な階段(facing === f)によってロックされていない場合にのみ、後方(-facing)の垂直な階段から 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' が明示的に指定されていない限り)。同じタイプのチェストを1列に3つ配置しないでください。
  • 自動ペアリング両開きドア (autoPairDoubleDoors()): 2つの一致する *_door ブロックが、同じ facing と Y を共有して並べて配置された場合、フェーズ 5 の最後に autoPairDoubleDoors() が実行され、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)): ベッドは常に...

[翻訳のため省略]

Individual skills in this repo

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

関連スキル