Communitygithub.com

Ultimate Blender

Blender 5.x를 위한 올인원 스킬로, 모델링, 조각, 리토폴로지/UV, PBR, 베이킹, 리깅, 애니메이션, 시뮬레이션, VFX, 조명, 렌더링, 게임 익스포트, 제품 턴테이블, Poly Haven, 사진-3D 변환, 90개 이상의 아트 스타일을 다룹니다. Blender를 blender-mcp 또는 헤드리스 CLI로 구동합니다.

Ultimate Blender란 무엇인가요?

Ultimate Blender는 Blender 5.x 환경에서 3D 에셋 제작 전반을 단일 스킬로 통합한 도구입니다. el4cteo의 검증된 bpy 스크립트와 Blender 5.x 규칙, arjun988의 테크니컬 아트 디렉터 워크플로우 (90개 이상의 전문가 및 스타일 가이드), kevinbadi의 제품 카메라 애니메이션, Poly Haven, Meshy 사진-3D 변환, Three.js 내보내기 기능을 하나로 융합했습니다. 이 스킬은 분석 → 계획 → 브리핑 → 실행 → 검증 → 전달로 이어지는 디렉터 워크플로우를 따르며, 모든 새로운 에셋에 대해 일관된 품질을 보장합니다. live 모드에서는 blender-mcp의 `execute_blender_code`를 통해 작은 단계로 작업하고, 헤드리스 모드에서는 `run_in_blender.py`를 통해 Blender 없이 CLI로 실행할 수 있습니다. 23개의 라우팅 가이드가 작업(모델링, 조각, 리깅, 애니메이션, 시뮬레이션, VFX, 조명, 렌더링, 익스포트 등)에 따라 정리되어 있으며, 아트 스타일은 별도 파일로 제공됩니다. 모든 스킬 경로는 상대 경로로 참조되며, 검증 단계에서는 QA 스크립트, 메시 통계, 스크린샷 리뷰 등을 필수로 수행해야 합니다. Blender 5.x의 핵심 규칙(Data API 우선, operator 사용 시 temp_override, Edit Mode 주의, enum 처리, 평가된 메시 사용 등)을 최우선으로 따르며, 모든 이전 조언보다 우선합니다. 이 스킬은 Claude Code, Cursor, Codex 등 MCP 기반 AI 에이전트와 완벽하게 호환됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/i-smiling-buddha/blender-animation-skill/tree/HEAD/skills/ultimate-blender

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

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

문서

Ultimate Blender은(는) 무엇을 하나요?

세 가지 팩을 하나로 통합한 스킬: el4cteo (검증된 bpy 스크립트 + Blender 5.x 규칙), arjun988 (테크니컬 아트 디렉터 워크플로우, 90개 이상의 전문가 및 스타일 가이드), kevinbadi (제품 카메라 애니메이션, Poly Haven, Meshy 사진-3D 변환, Three.js 내보내기).

이 파일 사용법: 먼저 읽은 후, 라우팅 테이블에서 작업과 일치하는 가이드만 여세요. 모든 가이드를 한 번에 로드하지 마세요. 각 가이드는 해당 주제에 대해 모든 소스 팩의 섹션을 포함합니다. 모든 경로는 이 스킬 폴더(<skill_root>)를 기준으로 합니다.

1. 디렉터 워크플로우 (모든 새 에셋)

분석 → 계획 → 브리핑 → 실행 → 검증 → 전달
  1. 분석: 에셋 용도 (히어로 / 표준 / 배경), 대상 (게임 / 영화 / 포트폴리오 / 제품 비디오), 플랫폼 (모바일 / 콘솔 / PC / 웹 / Roblox), 스타일, 애니메이션 (정적 / 리깅됨 / 애니메이션됨), 내보내기 형식을 확인하세요.
  2. 계획: 라우팅 테이블(섹션 4)에서 가이드를 선택하고, 폴리 및 텍스처 예산을 설정하세요 (refs/shared/polycount-budgets.md).
  3. 브리핑: 빠른 편집 이상의 작업이라면 Blender를 열기 전에 짧은 제작 브리핑(에셋, 예산, 사용 가이드, 단계, 내보내기 대상)을 작성하세요.
  4. 실행: MCP 또는 헤드리스(섹션 2)를 통해 작은 단계로 실행하세요. 새 코드를 작성하기 전에 번들 스크립트를 먼저 사용하세요.
  5. 검증: 섹션 5를 따르세요. 이 단계는 필수입니다.
  6. 전달: 내보낸 후 숫자와 파일 경로를 보고하세요.

참조 이미지가 첨부되었나요? 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 · Boolean FAST → FLOAT · 본 레이어 → 본 컬렉션 · bl_info → blender_manifest.toml · 5.3: 컴포지터 효과 스택, VSE EXPAND → RIPPLE. 전체 표: refs/blender-core/api-changes-5x.md. 코드 패턴: refs/blender-core/bpy-patterns.md.

4. 라우팅: 작업 → 가이드 (+ 스크립트)

작업열기주요 스크립트
단위, 네이밍, 컬렉션, 에셋 라이브러리, 배치/헤드리스 파이프라인, 애드온/확장guides/01-scene-pipeline.mdscene_audit, batch_process, assets/addon_template
하드 서피스, 베벨, 불리언, 가중치 노멀, 일반 모델링, 프로시저럴 모델링guides/02-modeling-hardsurface.mdapply_stack
소품, 킷배시, 가구, 차량, 메크, 건축 시각화guides/03-props-vehicles-archviz.mdapply_stack, build_pbr_material
조각, 멀티레즈, 리메시, 생물체, 몬스터guides/04-sculpting-creatures.mdsculpt_ops
인간 캐릭터, 아키타입, 의상, 얼굴 리그, ARKit / 바이짐guides/05-characters-clothing-face.mdgarment, shapekeys
헤어, 퍼, 헤어 카드guides/06-hair-groom.mdgroom
리토폴로지, UV 언랩, 텍셀 밀도, UDIM, 라이트맵 UVguides/07-retopology-uv.mdauto_retopo, uv_pack, texel_density
PBR 재질, 마모 및 때, 데칼, 트림 시트, 베이킹guides/08-materials-texturing-baking.mdbuild_pbr_material, smart_material, decal, bake_maps
지오메트리 노드, 프로시저럴 생성기, 분산guides/09-geometry-nodes.mdgn_builder
지형, 바이옴, 모듈러 키트, 식생, 세트 드레싱guides/10-environments-vegetation.mdterrain, scatter, kit_check
Rigify, 스키닝, 게임 골격, 키프레임, NLA, 모션 캡처 리타겟, 루프guides/11-rigging-animation.mdrigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check
강체, 천, 유체, 파괴, VFX, 비, 눈, 번개guides/12-simulation-vfx-weather.mdsim_setup, precipitation, surface_weather, lightning
조명 리그, HDRI, 룩데브, 카메라, 시간대, 안개, 분위기guides/13-lighting-camera-lookdev.mdturntable, scene_mood
Cycles/EEVEE 설정, 배치 렌더, 컴포지터guides/14-rendering-compositing.mdrender_batch
폴리 예산, LOD, 드로우 콜, 충돌 프록시guides/15-optimization-lod-collision.mdmesh_stats, make_lods
Unity, Unreal, Godot, Roblox, 웹/Three.js로 glTF/FBX/USD 내보내기guides/16-export-engines.mdexport_asset, node/blender-threejs-export.js
전달 전 QA (항상 수행)guides/17-qa-review.mdqa_check, review_shots
비디오 시퀀서 편집, 모션 트래킹, 카메라 해결guides/18-video-editing-tracking.mdvse_edit, track_camera
제품 비디오: 턴테이블, 슬로우 줌, 돌리, 크레인, 스피드 램프 루프, 완벽 루프, 제품 폴리싱guides/19-product-camera-animations.mdnode/blender-product-polish.js, turntable.py
Poly Haven HDRI, 텍스처, 스튜디오/쇼룸 장면, 재질 변형guides/20-polyhaven-assets.mdnode/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. 검증 ("완료"라고 말하기 전에 필수)

  1. 형용사가 아닌 숫자를 보고하세요: 삼각형 수, 객체, 재질, 치수 (ob.dimensions) 및 작성된 출력 파일.
  2. 지오메트리가 변경된 경우 scripts/qa_check.py를 실행하세요 (Z-파이팅, 분리된 부품, 비매니폴드, 뒤집힌 노멀, 배율).
  3. 결과를 확인하세요: MCP get_viewport_screenshot / look, 또는 헤드리스 scripts/review_shots.py 연락 시트.
  4. 게임 에셋의 경우 플랫폼 예산에 대해 scripts/mesh_stats.py를 실행하고 refs/shared/validation-checklist.md를 검토하세요.
  5. 내보낸 파일이 존재하고 크기가 0이 아닌지 확인하세요.

관련 스킬