Community코딩 & 개발github.com

Minecraft 이미지 빌더

업로드된 Minecraft 건축물 이미지나 스크린샷을 분석하여 정확한 치수, 블록 팔레트, 지붕 프로파일, 외관 깊이, 숨겨진 후면/내부 레이아웃을 역공학으로 추출하고, 즉시 다운로드 가능한 독립형 Node.js(.mjs) 생성기 파일을 출력합니다.

Minecraft 이미지 빌더란 무엇인가요?

이 스킬은 사용자가 제공한 Minecraft 건축물(주택, 오두막, 탑, 다리, 우물, 조각상, 가구, 사원, 복합 구조 등)의 이미지나 스크린샷을 분석하여, 단 한 번의 처리로 정확한 **컴포넌트 명세서**, **좌표 앵커 테이블**, 그리고 **독립형 ESM(.mjs) 파일**을 생성합니다. 생성된 `.mjs` 파일은 `node:fs`와 `node:zlib`만을 사용하여 Minecraft 26.3(DataVersion: 5023)용 gzip 압축 `.nbt` 구조 파일을 내보냅니다. 사용자는 추가 질문 없이 즉시 결과물을 받을 수 있으며, 파일 생성 도구를 통해 다운로드 가능한 형태로 제공됩니다. 이 스킬은 시각적 참조 자료로부터 정확한 블록 단위 재현이 필요한 경우에 특히 유용하며, 레드스톤 회로나 지형 변경과 같은 정적 블록 구조 외의 요소는 처리하지 않습니다. 워크플로우는 이미지 분석, 블록 레지스트리 검증, 좌표 앵커 테이블 매핑, 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 이미지 빌더은(는) 무엇을 하나요?

업로드된 모든 이미지나 스크린샷의 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단계: 심층 시각적 분석 및 컴포넌트 명세서

이미지를 아래에서 위로, 앞에서 뒤로 주의 깊게 검사한 후 간결하고 구조화된 청사진 및 컴포넌트 명세서를 출력합니다.

  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에는 없는 우발적인 중복 소품(예: 추가 랜턴 또는 표지판)은 무시합니다.
  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. 후면 및 내부 재구성 계획 (가려진 면):
    • 모든 패널에서 여전히 숨겨진 면이나 내부 모서리의 경우 대칭적이거나 기능적으로 일관된 레이아웃(창문 리듬 및 지붕 경사 일치)을 추론하고 심즈 네비게이션 표준(침대/작업대/디스플레이, 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)에 매핑합니다.

  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)이 외부 지붕 경사를 뚫지 않도록 합니다.
    • 회전 계단의 경우, Flight 1의 최상단 계단(Y_turn)과 같은 높이의 평평한 1x1(L-회전) 또는 1x2(U-회전) 전체 블록 착지대를 사용하고, 평평한 착지대 위에 2개의 공기 블록을 유지하며, Flight 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 도구 사용—파일 생성을 사용할 수 없는 경우가 아니면 채팅 응답에 원시 마크다운 코드 블록으로 전체 .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]

Individual skills in this repo

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

관련 스킬