Community이미지github.com

forge3d

참조 이미지나 간단한 요청에 맞춰 3D 모델을 Blender(스크립트 기반, 헤드리스, 설치 불필요)와 Blockbench(.bbmodel)로 제작합니다. 참조를 측정하고, 모델을 슬롯 블록아웃으로 배치하며, 각 파트를 개별적으로 조각하고(가능한 경우 서브 에이전트 사용), 각 파트와 조립된 모델을 참조와 비교하고, 도면의 선화를 추가합니다. 캐릭터, 생명체, 소품, 탈것 또는 Minecraft 스타일 모델(3D建模, Blender, Blockbench, 体素, 低模)과 같은 3D 에셋을 모델링, 조각, 복셀화, 텍스처링, 렌더링 또는 내보내기 요청에 사용합니다.

forge3d란 무엇인가요?

forge3d는 AI 에이전트(Claude Code, Cursor, Codex 등)가 참조 이미지 또는 텍스트 설명을 기반으로 3D 모델을 제작할 수 있도록 지원하는 전문 스킬입니다. 이 스킬은 Blender(사전 설치된 헤드리스 `bpy` 모듈 사용, 별도 설치 불필요)와 Blockbench(.bbmodel 형식) 플랫폼을 모두 지원합니다. forge3d의 핵심 가치는 **참조 측정**, **시각적 피드백**, **파트 분할 및 개별 검증**이라는 세 가지 주요 기능을 제공하여 AI가 정확하고 일관된 3D 모델을 제작할 수 있도록 돕는 데 있습니다. 스킬은 다섯 단계의 '파츠 루트(parts route)'를 통해 작동합니다. (1) `f3d ref` 명령어로 참조 이미지를 분석하여 좌표와 뷰를 분할하고, (2) 모델을 구성하는 모든 파트를 목록화하며, (3) `blockout.py`를 작성하여 각 파트의 위치와 크기를 정의하는 블록아웃 계약을 생성하고, (4) `f3d next` 명령어가 서브 에이전트(빌더, 리뷰어, 수리자)를 호출하여 각 파트를 독립적으로 조각하고 검토한 후, (5) 최종 모델을 조립하고 내보냅니다. 특히, 복잡한 모델의 경우 `gpt-6.2-astra` 또는 `gpt-6.2-sol`과 같은 AI 모델을 리드 에이전트로 사용하고 `spawn_agent`를 통해 서브 에이전트를 생성하여 병렬 작업을 수행하도록 설계되었습니다. 이는 AI 에이전트가 혼자서는 수행하기 어려운 여러 파트에 대한 동시 작업, 참조 이미지와의 정확한 정합성 검토, 전체적인 모델 일관성 유지를 가능하게 합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/quasar2333/forge3d/tree/main/forge3d

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

forge3d은(는) 무엇을 하나요?

당신은 훌륭한 3D 지오메트리를 작성할 수 있습니다. 하지만 혼자서 할 수 없는 것은 그림을 측정하고, 코드가 생성한 결과를 확인하며, 모든 파트에 집중하면서 전체 모델을 한눈에 파악하는 것입니다. forge3d는 이 세 가지를 제공합니다. 참조를 측정하고, 모든 빌드를 그 옆에 표시하며, 모델을 각각 독립적으로 조각되고 검사되는 파트로 분할하여 하나의 공유 프레임 안에 유지합니다. forge3d 없이 제작된 모델은 참조와 비교하여 검증되지 않습니다.

F3D="<이 SKILL.md 파일이 있는 폴더>/scripts/f3d.py"
python3 "$F3D" doctor

새 셸을 시작할 때는 절대 경로를 사용하십시오. 현재 작업 폴더에서 작업하십시오. 데스크톱 첨부 파일의 경우 "사용자가 언급한 파일" 아래의 경로를 사용하고, 다른 위치에 있는 경우 작업 폴더로 복사하십시오. 두 파일 경로를 모두 따옴표로 묶으십시오. 무인 빌드의 경우 도면에서 일상적인 설계 세부 사항을 결정하십시오. 참조를 기준으로 빌드하십시오. 사용자가 가리키지 않는 한, 재사용할 이전 모델을 찾기 위해 다른 폴더를 보지 마십시오.

기존 모델을 수정할 때는 복사본에서 작업하십시오. 요청된 슬롯을 완성된 인접 슬롯에 맞춰 재구축하고, 조립된 장면에서 검사한 후 승인된 지오메트리를 유지하십시오. 얼굴 수정의 경우 기존 머리카락과 몸체를 전체적으로 사용할 수 있습니다. 모든 슬롯을 재구축하면 사용자가 승인한 작업이 폐기됩니다.

Blender는 이미 여기에 있습니다. f3d는 개인 헤드리스 Blender(~/.cache/forge3d에 있는 bpy 모듈, 샌드박스가 해당 폴더를 금지하는 경우 F3D_HOME 설정)를 실행합니다. Blender 앱을 설치, 다운로드 또는 검색하지 마십시오. 모든 빌드는 Blender 앱에서 열리는 .blend 파일을 저장합니다. python3 "$F3D" python script.py는 모든 Blender Python 스크립트를 실행합니다.

f3d 명령은 5초에서 120초 정도 걸립니다. 폴링 대신 포그라운드에서 실행하고 한 번의 호출(Codex: yield_time_ms 120000 이상)로 완료될 때까지 기다리십시오. 작업 파일은 /tmp가 아닌 작업 폴더에 보관하십시오.

모든 곳에서의 규칙: 미터(meter), Z축 상향, 객체는 z = 0, x = y = 0에 서고 -Y 방향을 향함; 정면도에서 +X는 관찰자의 오른쪽입니다. 참조 객체는 --height를 전달하지 않는 한 높이가 1.0입니다.

참조 그림은 설계 도면이지, 사진 모음이 아닙니다. 턴어라운드 시트(turnaround sheet)는 대략적으로 일치하고 자유롭게 속임수를 쓰는 세 개의 도면입니다. 프로필은 정면도가 보여주는 것과 동일한 눈을 그리고, 활과 귀는 모든 뷰에서 관찰자를 향하며, 꼬리는 용지의 앞면과 뒷면에서 같은 쪽에 있습니다. 그것은 어떤 파트가 있는지, 크기가 얼마나 되는지, 어디에 있는지, 어떤 색상인지, 어떤 세부 사항이 있는지 알려줍니다. 하나의 일관된 3D 객체로 빌드하십시오.

어떤 경로를 선택할까요?

  • 캐릭터, 생명체, 여러 부분으로 구성된 모든 것 -> 아래의 파츠 루트(parts route)를 따르십시오.
  • 몇 가지 형태의 단순한 객체(머그컵, 검, 상자, 로우폴리 소품) -> 키트(kit)를 사용한 하나의 스크립트와 python3 "$F3D" build model.py --ref refs를 사용하십시오. references/modeling.md를 참조하십시오.
  • Blockbench -> 위의 어느 경로든 Blockbench 관련 내용을 추가로 적용하십시오. 아래 "Blockbench"를 참조하십시오.
  • 참조 그림이 없거나 한 뷰만 있고, 이미지를 생성할 수 있는 경우 -> 먼저 턴어라운드 시트(정면, 왼쪽 측면, 후면; 직교, 동일한 축척, 공통 지면선, 흰색 배경, 평평한 조명, 텍스트 없음)를 만드십시오. 프롬프트는 references/reference-and-gen3d.md에 있습니다.

파츠 루트 (Parts Route)

순서대로, 하나도 건너뛰지 않고: (1) f3d ref를 실행하고 완료될 때까지 기다리십시오; (2) 파트 목록을 작성하십시오; (3) blockout.py를 작성하고 f3d blockout을 실행하십시오; (4) f3d next를 반복해서 실행하십시오: 이 명령은 스폰할 서브 에이전트의 이름을 지정하며, 이 스킬은 이를 요청합니다: 빌더, 독립 리뷰어, 수리자 순서입니다; (5) model.py, f3d build를 실행하고 결과물을 전달하십시오. 당신의 작업은 레이아웃과 메모 작성이며, 빌드와 판단은 에이전트의 작업입니다.

1. 참조 측정

python3 "$F3D" ref sheet.png -o refs (30~90초)는 피사체를 잘라내고, 턴어라운드 시트를 뷰로 분할하며, 모든 뷰를 좌표 그리드에 배치하고 피사체가 잉크 외곽선으로 그려졌는지 여부를 보고합니다. 아무것도 작성하기 전에 완료될 때까지 기다리십시오. 이후의 모든 단계는 이 그림들에서 측정되며, 그 사이에 원시 시트에서 입력된 지오메트리는 다시 작업해야 합니다. refs/overview.png를 열고 뷰 이름을 확인하십시오. 잘못된 경우 --views front,right,back(읽기 순서; right는 해당 그림에서 피사체가 왼쪽을 향하고 있음을 의미, left는 오른쪽을 향하고 있음을 의미, skip은 그림을 무시함, 예: 후면의 두 번째 포즈)를 사용하여 다시 실행하십시오.

2. 파트 목록 작성

답변에 파트를 나열하십시오: 고유한 재질이거나 한 조각으로 떨어져 나올 수 있는 모든 것입니다. 일반적으로 캐릭터의 경우 9~14개입니다. 캐릭터는 몸체(body)를 가지며, 이는 하나의 파트입니다: body는 목, 몸통, 엉덩이 및 엉덩이 안쪽까지의 다리가 하나의 연속된 솔리드로, 다른 모든 것이 기반이 되는 부분입니다. 옷은 그 위의 파트(on="body")입니다. 몸체 없이 제작된 치마나 재킷은 빈 관(tube)입니다. 그 다음 머리(얼굴이 속함), 머리카락(길거나 정교한 머리카락은 두 파트: hair_front(앞머리와 옆머리), hair_back), 각 의복, 각 액세서리, 팔과 손, 신발, 꼬리 등입니다. 재질이 변경되는 곳, 한 물체가 다른 물체 위에 놓이는 곳, 무언가가 반복되는 곳(쌍은 하나의 파트)에서 분할하십시오. 각 파트에 대해 뷰가 속임수를 쓰는 곳에서 3D 진실을 한 번 결정하십시오: 몇 개가 있는지, 실제로 어디에 위치하는지, 실제로 어느 방향을 향하는지. 옷이 관절을 덮을 때, 기저 해부학을 소유한 슬롯의 이름을 지정하십시오. 예를 들어, 팔과 손목은 몸체 또는 팔 슬롯에, 소맷부리는 소매 슬롯에 넣으십시오. 두 허벅지는 모두 골반에 연결되어야 하며, 프로필에서 숨겨진 쪽도 포함합니다. 다른 슬롯이 하퇴부나 스타킹을 제공하는 경우, on=을 사용하여 해부학에 연결하여 도구가 양쪽을 독립적으로 확인하도록 하십시오.

3. 블록아웃 (Blockout)

blockout.py를 작성하십시오: 각각 올바른 위치와 크기에, 각 슬롯에 할당된, 거칠고 색칠되지 않은 자리 표시자 형태의 전체 모델입니다. 이것은 별도로 제작된 파트가 맞춰지도록 하는 계약입니다. refs/<view>_grid.png에서 위치와 크기를 읽으십시오.

# blockout.py
from forge3d import kit as k
head = k.sphere(radii=(0.215, 0.20, 0.225), at=(0, 0.005, 0.635))
k.slot("head", head, review="face", note="작은 귀를 가진 치비 스타일 머리. 그려진 눈 구멍, 시선, 눈썹, 입과 일치시키세요. 옆모습에서 뺨, 코, 턱을 형태화하세요. 머리카락이 이마의 일부를 덮습니다.")
skirt = k.cyl(r=0.235, r2=0.085, h=0.20, at=(0, 0, 0.17))
k.slot("skirt", skirt, on="torso", note="벨 모양 네이비 치마, 주름 처리되어 있으며, 밑단 근처에 금색 자수 띠가 둘러져 있고 그 아래 흰색 스캘럽 페티코트 러플이 있습니다.")
bows = [k.box(size=(0.07, 0.10, 0.09), at=(sx * 0.275, 0.09, 0.645)) for sx in (-1, 1)]
k.slot("bows", bows, on="hair", note="금색 구슬이 달린 연한 파란색 리본 나비 리본 한 쌍. 모든 그림이 관찰자를 향해 그려져 있습니다. 3D에서는 머리 측면에 바깥쪽과 약간 앞쪽을 향해 위치합니다.")
  • 도형: k.sphere(radii=), k.box, k.cyl, k.loft, k.sweep(path, r=): 거친 것이 맞습니다.
  • on=: 파트가 놓이거나 매달린 슬롯입니다. 파트는 그것이 놓인 완성된 파트를 기준으로 빌드되므로, 실제로 의존하는 것만 지정하고 체인은 짧게 유지하십시오.
  • note=: 파트 빌더가 그림 이상으로 알 수 있는 모든 것입니다. 그것이 무엇인지, 재료와 색상, 가지고 있는 모든 특징, 그리고 뷰가 속임수를 쓰는 곳에서 당신이 결정한 3D 진실을 말하십시오. 모호한 메모는 모호한 파트를 만듭니다.
  • review=: 슬롯 이름이 모호할 때 초점 검사를 할당합니다. 표정을 담당하는 파트에는 face, 정교한 자물쇠에는 hair, 엉덩이-다리 연결을 소유한 몸체에는 joint를 사용하십시오. 다른 사용자 우선 순위 기능에는 detail을 사용하십시오. 일반적인 파트는 어셈블리 리뷰를 공유합니다. 일반적인 머리, 머리카락 및 몸체 이름은 이미 자체 검사를 선택합니다. 얼굴에 대한 소유자를 하나 지정하십시오.
python3 "$F3D" blockout blockout.py --ref refs     # 10 초 -> parts/: plan.json, overview.png, 슬롯별 작업 지시서

parts/overview.png와 parts/blockout_compare.png를 여십시오. 참조의 모든 파트는 대략 올바른 크기와 올바른 위치(외곽선 IoU 약 0.8 정도면 충분)의 슬롯이 필요합니다. 수정하고 다시 실행하여 조건이 충족될 때까지 반복하십시오.

4. f3d next로 빌드 및 리뷰

python3 "$F3D" next        # 모든 파트의 상태와 지금 생성해야 할 정확한 에이전트를 출력합니다.

이 스킬은 명시적으로 서브 에이전트를 요청합니다. f3d next가 출력하는 대로 수행한 후, DONE을 출력할 때까지 다시 실행하십시오:

  • Codex에서 복잡한 참조 기반 빌드의 경우 gpt-6.2-astra를 리드 에이전트로 시작하십시오. 계정에서 gpt-6.2-sol을 제공하고 스폰 도구가 에이전트별 모델을 허용하는 경우 파트 빌더에 설정하십시오. 리드는 계획, 조립 및 최종 검사에 남겨두십시오. Sol 주도 세션은 전체 워크플로우를 실행할 수도 있습니다. 클라이언트가 서브 에이전트에 대한 모델 선택을 노출하지 않으면 모델을 설정하지 않고 기본값을 사용하십시오.
  • 한 번에 최대 세 개의 독립적인 작업을 디스패치하십시오. 새 빌더 또는 리뷰어의 경우 spawn_agent, fork_turns: "none", 출력된 작업 이름, 노력 및 메시지를 사용하십시오. 작업자가 보고할 때까지 기다린 후 next에게 준비된 작업을 요청하십시오. 각 파트에 하나의 활성 소유자를 지정하십시오. 수리는 가능한 경우 followup_task를 사용하여 원래 빌더에게 보내십시오. 리뷰어는 독립적으로 유지됩니다.
  • 모든 빌더는 핏과 렌더를 검사합니다. 얼굴이나 정교한 머리카락은 독립적인 클로즈업 검사를 받고, 수리 후 집중 검증을 받습니다. 몸체나 지정된 디테일은 한 번의 독립적인 검사를 받습니다. 다른 파트는 빌드 보고서에 구조적 문제가 보고되지 않는 한 어셈블리 리뷰를 공유합니다. 그려진 머리카락 교차점을 유지하고 바깥 옷이 덮고 있더라도 각 허벅지를 맞춰진 엉덩이 절단면에서 확인하십시오.
  • f3d review는 완성된 슬롯을 조립하여 사진을 만듭니다. 소유자별로 수리를 요청합니다. 두 번째 패스는 이러한 결과와 수리 회귀를 확인합니다. 파트가 안정되면 한 번에 결과물을 빌드하십시오. 한계점에서 해결되지 않은 모든 결과를 최종 저장된 장면에서 검사하십시오.

서브 에이전트 도구가 없는 경우에만: 각 파트를 해당 브리핑( references/parts.md; 직육면체 모델의 경우 references/blockbench.md의 "직육면체 파트 구축" 참조)에 따라 직접 빌드하고, 동일한 next 일정을 따르며 시각적 검사에는 references/review.md를 사용하십시오.

5. 조립 및 전달

# model.py
from forge3d import kit as k
parts = k.assemble()                 # 모든 완성된 파트는 해당 슬롯에; 나머지는 회색 블록아웃 형태
k.outline()                          # 도면의 잉크 선을 모든 개별 조각 주위에 추가 (f3d ref가 선화를 보고한 경우)
k.export("out/name.glb")             # 또한 .fbx .obj .stl .usdz .bbmodel

python3 "$F3D" build model.py --ref refs (1~2분)는 모델을 린트하고, out/model_sheet.png와 out/model_compare.png를 렌더링하며, out/model.blend를 저장합니다. f3d next가 DONE을 출력한 후, 한 번 직접 확인하십시오: python3 "$F3D" view out/model.blend --views az40el10,az-40el10,az140el10,az0el-50 --tile 1024 --cols 2 (마지막 것은 아래에서 본 것입니다). blockout.py에서 레이아웃 결과를 처리하고, f3d blockout을 다시 실행하고 f3d next를 따라 영향을 받는 슬롯을 다시 맞추십시오. 리뷰 한도에서는 나열된 결과를 전달 전 최종 저장된 빌드와 비교하십시오.

완료(Done)는 다음을 의미합니다: f3d next가 DONE을 출력함; 깔끔한 린트; 모든 그려진 특징이 완전하고 정확히 한 번 나타나며 아무것도 떠 있거나, 속이 비었거나, 묻히지 않은 3/4 뷰; 모든 뷰에서 외곽선 IoU가 대략 0.85 이상 (당신이 뷰가 속임수를 쓴다고 결정한 경우 제외).

요청된 것을 전달하십시오: 내보내기, .blend, 프리젠테이션 렌더링 (k.stage, k.camera, k.render를 기본 EEVEE 엔진과 함께 사용, references/modeling.md 참조). 최종 수치를 사용자에게 알리고, 비교 사진과 3/4 뷰를 보여주며, 무엇이 단순화되었는지, 리뷰에서 어떤 점이 미해결되었는지, 그리고 의도적으로 남겨둔 뷰 차이는 무엇인지 명확히 말하십시오.

얼굴이 보이는 캐릭터의 경우, 최종 스테이징된 파일에서 python3 "$F3D" portrait out/name.blend를 렌더링하십시오. 실제 헤어, 재질 및 조명을 사용하여 표정, 눈 깊이, 뺨 및 입 그림자를 검사하십시오. 시트에는 정렬된 참조 크롭, 정면, 프로필 및 양쪽 3/4 클로즈업이 포함됩니다. 장면에 여러 얼굴 슬롯이 있는 경우 --slot으로 하나를 선택하십시오. 얼굴이 너무 넓거나, 좁거나, 평평해 보이는 경우 portrait out/name.blend --form을 사용하여 맨 턱과 뺨 평면을 비교하십시오. 방해받지 않는 각 랜드마크에 대해, 측정된 전면 참조 좌표를 사용하여 --span Z LEFT_X RIGHT_X를 전달하십시오. 도구는 해당 위치의 메시 폭을 보고하고 두 참조 끝점을 표시합니다.

Blockbench

어떤 종류의 Blockbench 모델이 원하는지 묻거나 추론하십시오. 그것들은 다른 제품입니다:

  • 메시 모델 (참조에 가장 가깝고, 실제 텍스처가 있는 부드러운 형태; Generic Model 형식): 위와 같이 모델을 완성한 후 스크립트에서 k.export("out/name.bbmodel")를 사용하거나 python3 "$F3D" bb mesh model.py --ref refs -o out/name.bbmodel을 사용하십시오. 모든 객체는 이름이 지정된 편집 가능한 메시가 됩니다.
  • 설계된 직육면체 모델 (본 위의 상자 형태에 픽셀 아트 텍스처; Minecraft 모드, Bedrock / Java 엔티티 및 애니메이터가 필요로 하는 것). 여러 파트로 구성된 피사체는 블록아웃에 한 줄 bb.plan(height=80, format="bedrock")을 추가하여 파츠 루트를 따릅니다. 그러면 모든 파트가 본 위의 직육면체로 빌드되고 bb.assemble()이 결합합니다. 단순한 몹이나 소품은 bb.Model을 사용하는 하나의 스크립트입니다.
  • 복셀 모델 (모든 모델의 블록 같은 조각상, 많은 직육면체, 리그 없음): python3 "$F3D" bb voxelize model.py --ref refs --height 48 -o out/name.bbmodel.

단순히 "Blockbench로 만들어 주세요"라는 요청만 있는 경우, 직육면체 모델을 만드십시오. 이것이 Blockbench의 목적이며, 기계적이거나, 블록 같거나, 픽셀 아트 스타일의 피사체에 적합합니다. 부드럽고 곡선이 있는 그림(치비 캐릭터, 동물)이거나 요청받은 경우에만 메시 모델을 대신 만드십시오. 어떤 것을 만들었는지, 다른 형식도 가능하다고 말하십시오.

Blockbench가 설치된 경우 실제 앱에서 파일을 확인하십시오: python3 "$F3D" bb check out/name.bbmodel은 사설 숨겨진 Blockbench(오프라인, 자체 프로필)에서 열고, 로드된 내용을 보고하며, Blockbench 자체 보기를 저장하고, Blockbench의 내보내기 도구를 실행할 수 있습니다 (--export bedrock:out/name.geo.json).

API, 형식 및 픽셀 아트 지침: references/blockbench.md. Blockbench 스크립트를 작성하기 전에 읽으십시오.

문제 상황

  • 파트가 참조에서 누락되었습니다.

...

[번역을 위해 잘림]

관련 스킬