Minecraft 이미지 빌더은(는) 무엇을 하나요?
업로드된 모든 이미지나 스크린샷의 Minecraft 구조물을 역공학하여 정확한 컴포넌트 명세서, 좌표 앵커 테이블, 그리고 다운로드 가능한 독립형 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단계: 심층 시각적 분석 및 컴포넌트 명세서
이미지를 아래에서 위로, 앞에서 뒤로 주의 깊게 검사한 후 간결하고 구조화된 청사진 및 컴포넌트 명세서를 출력합니다.
- 다중 패널 기술 시트 및 축 정렬 (해당하는 경우):
- 업로드된 이미지가 다중 패널 기술 참조 시트(예:
01. 전면-우측 3/4 뷰,02. 후면-좌측 3/4 뷰,03. 내부 / 구조 세부 뷰)인 경우, 각 패널을 별도의 건축물로 취급하지 않고 모든 패널을 함께 종합합니다. X,Y,Z방향을 패널 01의 3D XYZ 축 가이즈모(빨간색X, 녹색Y위쪽, 파란색Z) 및"전면"바닥 레이블에 엄격히 고정합니다. 패널 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), 울타리/벽, 랜턴, 굴뚝, 단풍/덩굴 및 사진에서 보이는 장식용 소품.
- 기초 / 주춧돌: 예:
- 후면 및 내부 재구성 계획 (가려진 면):
- 모든 패널에서 여전히 숨겨진 면이나 내부 모서리의 경우 대칭적이거나 기능적으로 일관된 레이아웃(창문 리듬 및 지붕 경사 일치)을 추론하고 심즈 네비게이션 표준(침대/작업대/디스플레이,
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 블록 조합으로 변환하고 컴포넌트 명세서에 매핑을 기록합니다.
3단계: 좌표 앵커 테이블 및 5패스 구조적 규칙
코드를 작성하기 전에 컴포넌트 명세서를 정확한 좌표 앵커 테이블(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)이 외부 지붕 경사를 뚫지 않도록 합니다. - 회전 계단의 경우, Flight 1의 최상단 계단(
Y_turn)과 같은 높이의 평평한1x1(L-회전) 또는1x2(U-회전) 전체 블록 착지대를 사용하고, 평평한 착지대 위에2개의 공기 블록을 유지하며, Flight 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 도구 사용—파일 생성을 사용할 수 없는 경우가 아니면 채팅 응답에 원시 마크다운 코드 블록으로 전체 .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 뷰어 미리보기(https://www.shulkr.com/en/viewer) 및 Minecraft 구조 블록 로드 명령으로 마무리합니다.
독립형 .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);
}
…
[truncated for translation]