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

Minecraft Image Builder(画像からNBT生成)

アップロードされたMinecraft建築物の画像/スクリーンショットを解析し、正確な寸法やブロック構成を逆引きして、ダウンロード可能なNBT構造ファイル生成スクリプト(.mjs)を出力します。

Minecraft Image Builder(画像からNBT生成) とは?

このスキルは、ユーザーが提供するMinecraft建築物の画像を解析し、その構造を完全に再現するためのNBTファイル生成スクリプト(ESM、.mjs形式)を自動生成します。画像を1枚渡すだけで、寸法(XYZ)、ブロックパレット、屋根のプロファイル、ファサードの奥行き、背面や内部レイアウトまでを推定し、Component Manifest(構成要素マニフェスト)とCoordinate Anchor Table(座標アンカーテーブル)を作成。その後、依存関係ゼロのNode.jsスクリプトを出力し、Minecraft 26.3(DataVersion 5023)に対応したgzip圧縮のバニラNBTファイルを生成します。ユーザーに質問を一切せず、ワンパスで完了するのが特徴。対象プラットフォームはClaude CodeなどのAIエージェント。実際の処理は、詳細なビジュアル分析、ブロックレジストリとの整合性確認、5パスによる構成的ルールの適用、そして最終的な.mjsファイルの出力という4段階で進行します。

対応✓Claude Code~Codex CLI~Cursor
Part ofMobile
npx skills add https://github.com/marvaproject/minecraft-structure-builder/tree/HEAD/minecraft-builder-img

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

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

ドキュメント

Minecraft Image Builder

アップロードされたMinecraft構造物の画像やスクリーンショットを逆解析し、正確な Component Manifest、Coordinate Anchor Table、およびダウンロード可能なスタンドアロンで依存関係のない ESM(.mjs)ファイル(チャットに生のコードブロックをダンプするのではなく、ファイル生成ツールを使用)を出力します。このファイルは、Minecraft 26.3(DataVersion: 5023)用のgzip圧縮されたバニラ.nbtファイルをエクスポートします。ブレインストーミングの質問を一切行わず、シングルパスで即座に実行します。

使用タイミング

  • ユーザーがMinecraftの建築物(家、コテージ、塔、橋、井戸、像、家具、寺院、複合施設)の画像、スクリーンショット、レンダリングを提供し、それを.nbtまたはNode.jsコードに再現、コピー、逆解析、または生成したい場合。
  • ユーザーが追加の確認ややり取りなしに、直接的なビジュアル分析と構造化されたブロック/コンポーネントリスト、および即時の.mjsファイル出力を希望する場合。

対象外

  • テキストのみのゼロからの発想(画像なし) - ブレインストーミングやゼロからのアーキテクチャ設計が必要な場合は、minecraft-builderを使用してください。
  • レッドストーン回路、カスタム地形/テラフォーミング、チェストのNBTコンテンツ、エンティティのポージング - 制限を明確に述べ、代わりに静的ブロックシェルを再構築します。

フォルダ構成

minecraft-image-builder/
├── SKILL.md
└── registry_26_3.json

ワークフロー(直接実行 - ブレインストーミングなし)

画像が提供された場合、明確化やブレインストーミングの質問を一切行わないでください。以下の4つのフェーズを順次、単一のレスポンスで実行します。

フェーズ 1: 詳細なビジュアル分析とComponent Manifest

画像を下から上、前から後ろに向かって注意深く検査し、構造化された設計図とComponent Manifestを出力します。

  1. マルチパネル技術シートと軸合わせ(該当する場合):
    • アップロードされた画像がマルチパネルの技術参照シート(例: 01. 正面右 3/4 ビュー、02. 背面左 3/4 ビュー、03. 内部 / 構造詳細ビュー)の場合、各パネルを個別の建築物として扱うのではなく、すべてのパネルを統合して合成します。
    • X、Y、Zの方向は、パネル01の3D XYZ軸ギズモ(赤X、緑Y上、青Z)と、"FRONT"のフロアラベルに厳密に固定します。パネル02のギズモ矢印がパネル01のカメラ回転と矛盾する場合、反転または重複した矢印は無視します。
    • パネル01とパネル02をクロスチェックして、推測なしで4つの外壁すべてを抽出し、パネル03の断面図レイアウトを優先して内部の部屋の仕切り、階段、家具の配置を特定します。
    • パネル03内の、パネル01とパネル02の両方に表示されない偶発的な重複小道具(余分なランタンや看板など)は無視します。
  2. 全体の寸法とプロポーション(グリッド三角測量):
    • 幅(X)、高さ(Y)、奥行き(Z)に沿って可視ブロックを数えることで、正確なバウンディングボックス SIZE = [W, H, L] を推定し、1:1:1以外のプロポーションもスクリーンショットに忠実に保ちます。
    • AI生成の参照画像で壁や表面がスムーズ/非ボクセルに見える場合、平滑な壁の高さから推測するのではなく、1x1のフロアグリッド線、コーナーフレーミングピラー、窓ガラス、屋根の階段から正確なブロック数を三角測量します。
    • 標高データムレベルを定義します: Y_base、Y_floor1、Y_floor2(複数階の場合)、Y_roof_start、Y_roof_peak。
  3. 素材パレットの内訳(registry_26_3.jsonに照合):
    • 基礎 / 台座: 例: cobblestone、stone_bricks、tuff_bricks、deepslate_bricks。
    • フレーミングピラーと梁: 例: oak_log、spruce_log、stripped_dark_oak_log(axis付き)。
    • 主壁と副壁: 例: oak_planks、white_concrete、calcite、mud_bricks。
    • 屋根とトリム: 例: spruce_stairs、brick_stairs、deepslate_tile_stairs、スラブ、張り出しトリム。
    • 開口部、照明、外部詳細: 窓(glass_pane)、シャッター(*_trapdoor)、ドア(*_door)、フェンス/壁、ランタン、煙突、葉/ツタ、および画像で見える装飾的な小道具。
  4. 背面と内部の再構築計画(遮蔽された側面):
    • すべてのパネルでまだ隠れている面や内部コーナーについては、対称的または機能的に一貫性のあるレイアウト(窓のリズムと屋根の傾斜に一致)を推測し、The Sims Navi標準(ベッド/ワークステーション/ディスプレイ、4x4エリアごとに照明、そして歩行可能な1x2通路)に従って内部を整然と装飾します。ユーザーに質問しないでください。

フェーズ 2: ブロックレジストリの検証(registry_26_3.json)

  • 選択されたすべてのブロックID(minecraft:<name>)と状態プロパティを、スキルディレクトリ内のregistry_26_3.json(Minecraft 26.3 / DataVersion: 5023)に対して検証します。
  • ブロックIDや列挙値を決して発明しないでください。スクリーンショットに改造された、スムーズな、または非ボクセルの小道具(例: 滑らかな漆喰の壁、エアコン、ディスプレイ冷蔵庫、テキスト看板)が表示されている場合は、registry_26_3.jsonから最も近い有効なバニラ26.3ブロックの組み合わせに変換し、そのマッピングをComponent Manifestに記録します。

フェーズ 3: Coordinate Anchor Tableと5パス構築ルール

コードを作成する前に、Component Manifestを正確なCoordinate Anchor Table(X, Y, Z)にマッピングします。

  1. シェルとフレーミングピラー: コーナーポスト(X, Z)座標と外壁平面。
  2. 内部フロア境界(X_min..X_max、Z_min..Z_max): すべての内部家具がX_wall_west + 1 .. X_wall_east - 1およびZ_wall_north + 1 .. Z_wall_south - 1の範囲内に厳密に収まるようにし、パス5が壁を上書きしないようにします。
  3. ドア、窓、バルコニー: 正確な(X, Y, Z) + facing。ドア/ゲートの前後に1-2ブロックの歩行可能な床タイルを確保し、柵で囲まれたバルコニーには、外側の手すりの内側に>= 1ブロックの歩行可能な床列があることを確認します(depth >= 2)。
  4. 階段と屋根裏棟の位置合わせ:
    • 歩行可能な階段のステップと階段椅子は、shape: 'straight' を明示的に設定し、autoConnectStairs() が屋根の階段のみを成形するようにします。
    • 傾斜した屋根の上層階/屋根裏に上がる階段は、中央の高い屋根の棟(Y_roof_peak)の下で終端する必要があります。これにより、carveStairHeadroom(x, y, z, 3) が外側の屋根斜面を突き破ることがなくなります。
    • 曲がり階段の場合は、フライト1の一番上の階段(Y_turn)と同じ高さに、平らな1x1(Lターン)または1x2(Uターン)のフルブロック踊り場を使用します。平らな踊り場の上には2ブロックの空気を確保し、フライト2をY_turn + 1から開始します。
    • 上昇する階段のステップの真上(step.y + 3 >= Y_upper)にある上層階のタイルのみを削除し、開いた階段の吹き抜けの端には*_fence安全手すりを配置します。
  5. 個別グリッド隣接と煙突キャップ:
    • 壁に取り付けるアイテム(wall_torch、*_wall_sign、ladder、trapdoorシャッター、vine)は、隣接する空気ブロック(X_wall +/- 1 または Z_wall +/- 1)を占有し、壁ブロックを上書きしないようにします。
    • 屋根の頂上から上に延びる外部煙突の場合、上部のcampfireの周りの4つの水平方向の隣接ブロックすべてをチェックし、airに隣接するすべての側面に開いた*_trapdoor(open: 'true'、half: 'top')を配置します。

フェーズ 4: 即時のスタンドアロン.mjsファイル出力と実行手順

完全な自己完結型ESMファイル(<build-name>.mjs)を、ダウンロード可能な.mjsファイルとして生成してエクスポートします(可能であればfile_genツールを使用し、チャットレスポンス内に生のMarkdownコードブロックとして.mjsのソースコード全体をダンプしないでください。ファイル生成が利用できない場合は除く)。node:fsとnode:zlibのみを使用し、5パス構築レイヤリングの順序で行います。

  • パス 1: 基礎、杭、床スラブ。
  • パス 2: フレーミングピラー、外壁、窓、バルコニー、ドア(placeDoor)。
  • パス 3: 屋根(1ブロックの張り出し付き)と外部煙突(4面キャップ付き)。
  • パス 4: 階段(shape: 'straight')、正確な階段吹き抜けの床の切り欠き、安全手すり、carveStairHeadroom()。
  • パス 5: 内部家具(部屋の境界内)、placeBed()、壁の取付具、照明、続いてautoConnectStairs()、autoPairDoubleDoors()、connectDoubleChests()、connectWalls()、connectFencesAndPanes()。

ランタイムのthrow new Errorバリデーション関数は含めないでください。これにより、スクリプトが常にクリーンに実行されます。常に、簡単な実行手順、Shulkr 3D Viewerプレビュー(https://www.shulkr.com/en/viewer)、およびMinecraft Structure Blockのロードコマンドを最後に含めてください。

スタンドアロン.mjsテンプレート

import fs from 'node:fs';
import zlib from 'node:zlib';

class NbtWriter {
  constructor() { this.chunks = []; }
  u8(v) { const b = Buffer.alloc(1); b.writeUInt8(v); this.chunks.push(b); }
  i16(v) { const b = Buffer.alloc(2); b.writeInt16BE(v); this.chunks.push(b); }
  i32(v) { const b = Buffer.alloc(4); b.writeInt32BE(v); this.chunks.push(b); }
  str(s) { const buf = Buffer.from(s, 'utf8'); this.i16(buf.length); this.chunks.push(buf); }
  tagHeader(type, name) { this.u8(type); this.str(name); }
  tagInt(name, v) { this.tagHeader(3, name); this.i32(v); }
  tagString(name, v) { this.tagHeader(8, name); this.str(v); }
  tagListHeader(name, elemType, length) { this.tagHeader(9, name); this.u8(elemType); this.i32(length); }
  tagCompoundStart(name) { this.tagHeader(10, name); }
  tagEnd() { this.u8(0); }
  toBuffer() { return Buffer.concat(this.chunks); }
}

const SIZE = [11, 12, 13];
const palette = [];
const paletteMap = new Map();
const blockGrid = new Map();

const DIR_VEC = {
  north: [0, -1],
  south: [0, 1],
  west: [-1, 0],
  east: [1, 0],
};
const LEFT_OF = { north: 'west', west: 'south', south: 'east', east: 'north' };
const RIGHT_OF = { north: 'east', east: 'south', south: 'west', west: 'north' };

function getStateIndex(name, props = {}) {
  const keys = Object.keys(props).sort();
  const key = `${name}|${keys.map((k) => `${k}=${props[k]}`).join(',')}`;
  if (!paletteMap.has(key)) {
    paletteMap.set(key, palette.length);
    palette.push({ Name: name, Properties: props });
  }
  return paletteMap.get(key);
}

function setBlock(x, y, z, name, props = {}) {
  if (x < 0 || x >= SIZE[0] || y < 0 || y >= SIZE[1] || z < 0 || z >= SIZE[2]) return;
  const posKey = `${x},${y},${z}`;
  if (name === 'minecraft:air') {
    blockGrid.delete(posKey);
    return;
  }
  blockGrid.set(posKey, { pos: [x, y, z], name, props, state: getStateIndex(name, props) });
}

function fill(x1, y1, z1, x2, y2, z2, name, props = {}) {
  for (let x = Math.min(x1, x2); x <= Math.max(x1, x2); x++) {
    for (let y = Math.min(y1, y2); y <= Math.max(y1, y2); y++) {
      for (let z = Math.min(z1, z2); z <= Math.max(z1, z2); z++) {
        setBlock(x, y, z, name, props);
      }
    }
  }
}

function placeDoor(x, y, z, blockId, facing = 'south', hinge = 'left', open = 'false') {
  setBlock(x, y, z, blockId, { facing, half: 'lower', hinge, open, powered: 'false' });
  setBlock(x, y + 1, z, blockId, { facing, half: 'upper', hinge, open, powered: 'false' });
}

function placeBed(headX, y, headZ, blockId = 'minecraft:red_bed', facing = 'north') {
  const [dx, dz] = DIR_VEC[facing] ?? [0, -1];
  setBlock(headX, y, headZ, blockId, { facing, part: 'head', occupied: 'false' });
  setBlock(headX - dx, y, headZ - dz, blockId, { facing, part: 'foot', occupied: 'false' });
}

function carveStairHeadroom(x, y, z, height = 3) {
  for (let dy = 1; dy <= height; dy++) {
    setBlock(x, y + dy, z, 'minecraft:air');
  }
}

function autoConnectStairs(skipPositions = new Set()) {
  for (const b of blockGrid.values()) {
    if (!b.name.endsWith('_stairs')) continue;
    const [x, y, z] = b.pos;
    if (skipPositions.has(`${x},${y},${z}`)) continue;
    if (b.props.shape !== undefined) continue;
    const f = b.props.facing;
    const half = b.props.half ?? 'bottom';
    if (!f || !DIR_VEC[f]) continue;

    const getStairAt = (nx, ny, nz) => {
      const nb = blockGrid.get(`${nx},${ny},${nz}`);
      if (!nb || !nb.name.endsWith('_stairs')) return null;
      if ((nb.props.half ?? 'bottom') !== half) return null;
      return nb.props.facing;
    };

    const [fx, fz] = DIR_VEC[f];
    const [lx, lz] = DIR_VEC[LEFT_OF[f]];
    const [rx, rz] = DIR_VEC[RIGHT_OF[f]];
    const frontFacing = getStairAt(x + fx, y, z + fz);
    const backFacing = getStairAt(x - fx, y, z - fz);
    const leftFacing = getStairAt(x + lx, y, z + lz);
    const rightFacing = getStairAt(x + rx, y, z + rz);
    let shape = 'straight';

    if (frontFacing === LEFT_OF[f] && rightFacing !== f) shape = 'outer_left';
    else if (frontFacing === RIGHT_OF[f] && leftFacing !== f) shape = 'outer_right';
    else if (backFacing === LEFT_OF[f] && leftFacing !== f) shape = 'inner_left';
    else if (backFacing === RIGHT_OF[f] && rightFacing !== f) shape = 'inner_right';

    const nextProps = {
      ...b.props,
      half,
      shape,
      waterlogged: b.props.waterlogged ?? 'false',
    };
    b.props = nextProps;
    b.state = getStateIndex(b.name, nextProps);
  }
}

function autoPairDoubleDoors() {
  const paired = new Set();
  for (const b of blockGrid.values()) {
    if (!b.name.endsWith('_door') || b.name === 'minecraft:iron_door') continue;
    if (b.props.half !== 'lower') continue;
    const [x, y, z] = b.pos;
    const key = `${x},${y},${z}`;
    if (paired.has(key)) continue;

    const f = b.props.facing ?? 'south';
    if (!DIR_VEC[f]) continue;
    const [lx, lz] = DIR_VEC[LEFT_OF[f]];
    const viewerRightKey = `${x + lx},${y},${z + lz}`;
    const neighborLower = blockGrid.get(viewerRightKey);

    if (
      neighborLower &&
      !paired.has(viewerRightKey) &&
      neighborLower.name === b.name &&
      neighborLower.props.half === 'lower' &&
      (neighborLower.props.facing ?? 'south') === f
    ) {
      const setDoorHinge = (dx, dz, hinge) => {
        for (const dy of [0, 1]) {
          const halfBlock = blockGrid.get(`${dx},${y + dy},${dz}`);
          if (halfBlock && halfBlock.name === b.name) {
            halfBlock.props = { ...halfBlock.props, hinge };
            halfBlock.state = getStateIndex(halfBlock.name, halfBlock.props);
          }
        }
      };
      setDoorHinge(x, z, 'left');
      setDoorHinge(x + lx, z + lz, 'right');
      paired.add(key);
      paired.add(viewerRightKey);
    }
…

[翻訳のため省略]

Individual skills in this repo

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

関連スキル