Ultimate Blender은(는) 무엇을 하나요?
세 가지 팩을 하나로 통합한 스킬: el4cteo (검증된 bpy 스크립트 + Blender 5.x 규칙), arjun988 (테크니컬 아트 디렉터 워크플로우, 90개 이상의 전문가 및 스타일 가이드), kevinbadi (제품 카메라 애니메이션, Poly Haven, Meshy 사진-3D 변환, Three.js 내보내기).
이 파일 사용법: 먼저 읽은 후, 라우팅 테이블에서 작업과 일치하는 가이드만 여세요. 모든 가이드를 한 번에 로드하지 마세요. 각 가이드는 해당 주제에 대해 모든 소스 팩의 섹션을 포함합니다. 모든 경로는 이 스킬 폴더(<skill_root>)를 기준으로 합니다.
1. 디렉터 워크플로우 (모든 새 에셋)
분석 → 계획 → 브리핑 → 실행 → 검증 → 전달
- 분석: 에셋 용도 (히어로 / 표준 / 배경), 대상 (게임 / 영화 / 포트폴리오 / 제품 비디오), 플랫폼 (모바일 / 콘솔 / PC / 웹 / Roblox), 스타일, 애니메이션 (정적 / 리깅됨 / 애니메이션됨), 내보내기 형식을 확인하세요.
- 계획: 라우팅 테이블(섹션 4)에서 가이드를 선택하고, 폴리 및 텍스처 예산을 설정하세요 (
refs/shared/polycount-budgets.md). - 브리핑: 빠른 편집 이상의 작업이라면 Blender를 열기 전에 짧은 제작 브리핑(에셋, 예산, 사용 가이드, 단계, 내보내기 대상)을 작성하세요.
- 실행: MCP 또는 헤드리스(섹션 2)를 통해 작은 단계로 실행하세요. 새 코드를 작성하기 전에 번들 스크립트를 먼저 사용하세요.
- 검증: 섹션 5를 따르세요. 이 단계는 필수입니다.
- 전달: 내보낸 후 숫자와 파일 경로를 보고하세요.
참조 이미지가 첨부되었나요? refs/shared/reference-image-match.md를 따르세요: refs/shared/reference-analysis-template.md를 작성하고, 미세 디테일 전에 카메라를 일치시키고, 스크린샷 비교를 반복한 후 refs/shared/visual-match-checklist.md로 검증하세요.
전체 디렉터 플레이북(브리핑, 멀티 스킬 레시피, 결정 트리 포함): refs/director-full.md.
네이밍: refs/shared/naming-conventions.md · 파이프라인: refs/shared/asset-pipeline.md · MCP: refs/shared/mcp-integration.md, refs/shared/mcp-tools.md.
2. 실행
실시간 (blender-mcp execute_blender_code): 작은 단계로 작업하고 필요한 것만 출력하세요. 번들 스크립트를 호출하려면:
import sys, importlib; sys.path.insert(0, r"<skill_root>/scripts")
import qa_check; importlib.reload(qa_check); print(qa_check.run(objects=["Chair"]))
각 MCP 호출은 새 네임스페이스에서 실행되므로 매번 다시 import하세요. reload는 스크립트를 편집한 후에만 사용하세요.
헤드리스 (셸, MCP 불필요): 스크립트의 JSON만 출력합니다.
python <skill_root>/scripts/run_in_blender.py --blend in.blend <skill_root>/scripts/<script.py> -- --objects Chair --save out.blend
python <skill_root>/scripts/run_in_blender.py --expr "import bpy; print(len(bpy.data.objects))"
Windows: PowerShell을 선호합니다. Git Bash에서는 MSYS_NO_PATHCONV=1을 접두사로 사용하고 $(cygpath -m ~/.claude/skills)/ultimate-blender/...를 사용하세요. blender.exe가 PATH에 있거나 경로를 전달해야 합니다.
세션 첫 호출: scripts/env_report.py를 실행하세요 (버전, 엔진, GPU, 애드온, 단위, 색상 관리).
Node 도우미 (kevinbadi; 포트 9876에서 blender-mcp와 통신): node <skill_root>/scripts/node/<name>.js --help.
3. Blender 5.x 규칙 (이전 가이드의 조언보다 우선)
- Data API를 연산자보다 우선:
bpy.data,bmesh,mesh.attributes,foreach_get/set과 numpy를 사용하세요. 연산자는 컨텍스트가 필요하며, 백그라운드 모드에는 3D 뷰가 없습니다. - 불가피한 연산자:
with bpy.context.temp_override(object=ob, active_object=ob, selected_objects=[ob], selected_editable_objects=[ob]): bpy.ops...를 사용한 후{'FINISHED'}를 확인하세요. - 편집 모드:
ob.data는 편집 모드인 동안 오래된 상태입니다.bmesh.from_edit_mesh+update_edit_mesh를 사용하거나 먼저 OBJECT 모드로 전환하세요. - 노드: 이름이 아닌
type("BSDF_PRINCIPLED")으로 찾으세요. 이름은 지역화되기 때문입니다. - 열거형:
bl_rna.properties[p].enum_items에서 읽으세요. 동적 열거형(render.engine,view_transform)의 경우try/except TypeError안에서 할당하세요. - 엔진:
BLENDER_EEVEE,CYCLES,BLENDER_WORKBENCH. GPU:scene.cycles.device="GPU"+ 환경설정compute_device_type. - 평가된 메시:
ob.evaluated_get(dg).to_mesh()를 사용한 후 항상to_mesh_clear()를 호출하세요.matrix_world를 읽기 전에view_layer.update()를 호출하세요. - 해제된 데이터: 제거하거나 적용하기 전에 이름을 수집하고, 이전 Python 참조를 재사용하지 마세요.
- 이름: "Cube.001"을 절대 신뢰하지 마세요. 명시적으로 이름을 바꾸고
bpy.data.objects[name]으로 객체를 조회하세요. - 배율: 1 단위 = 1 m. 베벨, 리깅, 물리, 베이킹 및 내보내기 전에 회전 및 배율을 적용하세요.
- 실시간 세션은 사용자의 작업입니다:
read_factory_settings를 절대 호출하지 말고, 자신이 만들지 않은 데이터를 삭제하지 말며, 파괴적인 일괄 편집 전에 백업(save_as_mainfile(copy=True))을 저장하세요. - 백그라운드 GPU:
gpu.init()을 호출하세요 (5.2+).bgl은 더 이상 존재하지 않습니다. 조각 모드는-b에서 충돌하므로scripts/sculpt_ops.py를 사용하세요. - 5.x API 변경사항:
action.fcurves→ channelbags ·scene.node_tree→scene.compositing_node_group·material.use_nodes사용 중단 ·mod["Socket_2"]→mod.properties.inputs.Socket_2.value·BLENDER_EEVEE_NEXT→BLENDER_EEVEE· BooleanFAST→FLOAT· 본 레이어 → 본 컬렉션 ·bl_info→blender_manifest.toml· 5.3: 컴포지터 효과 스택, VSEEXPAND→RIPPLE. 전체 표:refs/blender-core/api-changes-5x.md. 코드 패턴:refs/blender-core/bpy-patterns.md.
4. 라우팅: 작업 → 가이드 (+ 스크립트)
| 작업 | 열기 | 주요 스크립트 |
|---|---|---|
| 단위, 네이밍, 컬렉션, 에셋 라이브러리, 배치/헤드리스 파이프라인, 애드온/확장 | guides/01-scene-pipeline.md | scene_audit, batch_process, assets/addon_template |
| 하드 서피스, 베벨, 불리언, 가중치 노멀, 일반 모델링, 프로시저럴 모델링 | guides/02-modeling-hardsurface.md | apply_stack |
| 소품, 킷배시, 가구, 차량, 메크, 건축 시각화 | guides/03-props-vehicles-archviz.md | apply_stack, build_pbr_material |
| 조각, 멀티레즈, 리메시, 생물체, 몬스터 | guides/04-sculpting-creatures.md | sculpt_ops |
| 인간 캐릭터, 아키타입, 의상, 얼굴 리그, ARKit / 바이짐 | guides/05-characters-clothing-face.md | garment, shapekeys |
| 헤어, 퍼, 헤어 카드 | guides/06-hair-groom.md | groom |
| 리토폴로지, UV 언랩, 텍셀 밀도, UDIM, 라이트맵 UV | guides/07-retopology-uv.md | auto_retopo, uv_pack, texel_density |
| PBR 재질, 마모 및 때, 데칼, 트림 시트, 베이킹 | guides/08-materials-texturing-baking.md | build_pbr_material, smart_material, decal, bake_maps |
| 지오메트리 노드, 프로시저럴 생성기, 분산 | guides/09-geometry-nodes.md | gn_builder |
| 지형, 바이옴, 모듈러 키트, 식생, 세트 드레싱 | guides/10-environments-vegetation.md | terrain, scatter, kit_check |
| Rigify, 스키닝, 게임 골격, 키프레임, NLA, 모션 캡처 리타겟, 루프 | guides/11-rigging-animation.md | rigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check |
| 강체, 천, 유체, 파괴, VFX, 비, 눈, 번개 | guides/12-simulation-vfx-weather.md | sim_setup, precipitation, surface_weather, lightning |
| 조명 리그, HDRI, 룩데브, 카메라, 시간대, 안개, 분위기 | guides/13-lighting-camera-lookdev.md | turntable, scene_mood |
| Cycles/EEVEE 설정, 배치 렌더, 컴포지터 | guides/14-rendering-compositing.md | render_batch |
| 폴리 예산, LOD, 드로우 콜, 충돌 프록시 | guides/15-optimization-lod-collision.md | mesh_stats, make_lods |
| Unity, Unreal, Godot, Roblox, 웹/Three.js로 glTF/FBX/USD 내보내기 | guides/16-export-engines.md | export_asset, node/blender-threejs-export.js |
| 전달 전 QA (항상 수행) | guides/17-qa-review.md | qa_check, review_shots |
| 비디오 시퀀서 편집, 모션 트래킹, 카메라 해결 | guides/18-video-editing-tracking.md | vse_edit, track_camera |
| 제품 비디오: 턴테이블, 슬로우 줌, 돌리, 크레인, 스피드 램프 루프, 완벽 루프, 제품 폴리싱 | guides/19-product-camera-animations.md | node/blender-product-polish.js, turntable.py |
| Poly Haven HDRI, 텍스처, 스튜디오/쇼룸 장면, 재질 변형 | guides/20-polyhaven-assets.md | node/polyhaven-*.js |
사진 → 텍스처 3D 모델 (Meshy API, MESHY_API_KEY 필요) | guides/21-image-to-3d.md | 그 후 auto_retopo, qa_check |
| 종단간 플레이북 (소품, 캐릭터, Roblox, 제품 샷) | guides/22-workflow-recipes.md | |
| 선택적 외부 WebSocket 툴킷 (Dev-GOM 애드온을 통한 Mixamo 리타겟) | guides/23-websocket-toolkit.md | (번들되지 않음) |
스타일 방향: 전체 파일이 아닌 이 파일들에서 하나의 섹션만 여세요.
| 스타일 요청 | 열기 |
|---|---|
| 스타일라이즈드, 사실적, 로우폴리, 애니메이션/만화, 치비, 카툰, 코믹, 핸드페인팅, 픽셀, 복셀, 아이소메트릭, HD-2D, 레트로 8/16비트, 느와르, 툰/NPR, 콘솔 시대 (PS1–PS5, CRT/VHS) | styles/art-styles.md |
| 호러, PSX 호러, 인디, 파운드 푸티지, 바디, 코즈믹, 포크, 마스코트 호러, 리미널, 웨이드코어 | styles/horror.md |
| 판타지, SF/펑크, 아포칼립스, 역사적, 바이옴, 아늑한, 어둡고/거친, 초현실, 브루탈리스트, 네온 레트로퓨처리즘 | styles/worlds-moods.md |
| 장르 아트 방향: 액션, 카드/아이들, 메트로이드베니아, VN, 오픈 월드, 플랫포머, 레이싱, RPG, 슈터, 소울라이크, 스텔스, 전략, 서바이벌 | styles/game-genres.md |
주제별 심층 참조 자료는 refs/<original-skill-name>/에 있으며, 가이드는 이들을 직접 링크합니다.
5. 검증 ("완료"라고 말하기 전에 필수)
- 형용사가 아닌 숫자를 보고하세요: 삼각형 수, 객체, 재질, 치수 (
ob.dimensions) 및 작성된 출력 파일. - 지오메트리가 변경된 경우
scripts/qa_check.py를 실행하세요 (Z-파이팅, 분리된 부품, 비매니폴드, 뒤집힌 노멀, 배율). - 결과를 확인하세요: MCP
get_viewport_screenshot/look, 또는 헤드리스scripts/review_shots.py연락 시트. - 게임 에셋의 경우 플랫폼 예산에 대해
scripts/mesh_stats.py를 실행하고refs/shared/validation-checklist.md를 검토하세요. - 내보낸 파일이 존재하고 크기가 0이 아닌지 확인하세요.