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を出力します。
- マルチパネル技術シートと軸合わせ(該当する場合):
- アップロードされた画像がマルチパネルの技術参照シート(例:
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の両方に表示されない偶発的な重複小道具(余分なランタンや看板など)は無視します。
- アップロードされた画像がマルチパネルの技術参照シート(例:
- 全体の寸法とプロポーション(グリッド三角測量):
- 幅(
X)、高さ(Y)、奥行き(Z)に沿って可視ブロックを数えることで、正確なバウンディングボックスSIZE = [W, H, L]を推定し、1:1:1以外のプロポーションもスクリーンショットに忠実に保ちます。 - AI生成の参照画像で壁や表面がスムーズ/非ボクセルに見える場合、平滑な壁の高さから推測するのではなく、
1x1のフロアグリッド線、コーナーフレーミングピラー、窓ガラス、屋根の階段から正確なブロック数を三角測量します。 - 標高データムレベルを定義します:
Y_base、Y_floor1、Y_floor2(複数階の場合)、Y_roof_start、Y_roof_peak。
- 幅(
- 素材パレットの内訳(
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)、フェンス/壁、ランタン、煙突、葉/ツタ、および画像で見える装飾的な小道具。
- 基礎 / 台座: 例:
- 背面と内部の再構築計画(遮蔽された側面):
- すべてのパネルでまだ隠れている面や内部コーナーについては、対称的または機能的に一貫性のあるレイアウト(窓のリズムと屋根の傾斜に一致)を推測し、The Sims Navi標準(ベッド/ワークステーション/ディスプレイ、
4x4エリアごとに照明、そして歩行可能な1x2通路)に従って内部を整然と装飾します。ユーザーに質問しないでください。
- すべてのパネルでまだ隠れている面や内部コーナーについては、対称的または機能的に一貫性のあるレイアウト(窓のリズムと屋根の傾斜に一致)を推測し、The Sims Navi標準(ベッド/ワークステーション/ディスプレイ、
フェーズ 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)にマッピングします。
- シェルとフレーミングピラー: コーナーポスト
(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の範囲内に厳密に収まるようにし、パス5が壁を上書きしないようにします。 - ドア、窓、バルコニー: 正確な
(X, Y, Z)+facing。ドア/ゲートの前後に1-2ブロックの歩行可能な床タイルを確保し、柵で囲まれたバルコニーには、外側の手すりの内側に>= 1ブロックの歩行可能な床列があることを確認します(depth >= 2)。 - 階段と屋根裏棟の位置合わせ:
- 歩行可能な階段のステップと階段椅子は、
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安全手すりを配置します。
- 歩行可能な階段のステップと階段椅子は、
- 個別グリッド隣接と煙突キャップ:
- 壁に取り付けるアイテム(
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);
}
…
[翻訳のため省略]