Communitygithub.com

blender-3d-production

블렌더 및 3D 프로덕션 작업(모델링, UV, 베이킹, PBR, 셰이더, 조명, 렌더링, 리깅, 애니메이션, 지오메트리 노드, 시뮬레이션/VFX, bpy 스크립팅, 최적화/LOD, 게임 엔진/GTA V/FiveM 내보내기 등)을 수행할 때 사용합니다. 또한 3D 결과물이 'AI로 만든 것처럼' 보이거나 '싸구려', '가짜', '평면적으로' 보일 때, 또는 AI 생성 메시를 프로덕션에 바로 사용할 수 있도록 만들어야 할 때 유용합니다.

blender-3d-production란 무엇인가요?

이 스킬은 Blender 3D 프로덕션 전반을 포괄하는 전문 지식 베이스입니다. 하드 서페이스 및 오가닉 모델링, UV 매핑, PBR 텍스처 베이킹, 셰이더, 조명, 렌더링부터 리깅, 웨이트 페인팅, 애니메이션, 지오메트리 노드, VFX 시뮬레이션까지 모든 3D 파이프라인을 다룹니다. 특히 GTA V/FiveM (Sollumz, CodeWalker, ydr, yft, ytd, ybn, ytyp, ycd), Unreal Engine, Unity, Godot, Minecraft 등 다양한 대상 플랫폼으로의 내보내기 규칙과 최적화 전략을 상세히 설명합니다. Blender Python API (bpy)를 활용한 스크립팅 자동화, 비파괴 편집 워크플로우, 품질 검증(QA 리포트, 리뷰 렌더) 등 프로덕션 레벨의 작업 기준을 제시하며, AI가 생성한 3D 메시를 실제 게임이나 영상에 사용할 수 있도록 다듬는 방법도 포함합니다. 각 세부 영역은 참조 파일(references)로 분리되어 있어 필요한 부분만 빠르게 찾아 쓸 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SungJinWooKuragame/blender-skill/tree/main/skills/blender-3d-production

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

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

문서

Blender 3D 프로덕션

에셋은 목적지에서 제대로 작동할 때 비로소 완성됩니다: 깨끗한 지오메트리, 실제 스케일, 내보내기 가능한 재질, 측정된 숫자. 뷰포트에서 예뻐도 충분하지 않습니다.

1. 씬을 건드리기 전에

  1. 대상이 모든 것을 결정합니다: 렌더/제품, GTA/FiveM, Unreal, Unity, Godot, Minecraft, 3D 프린팅. 대상이 정해지지 않았다면 물어보십시오. 이것이 유일한 필수 질문입니다. 나머지는 선택하고 한 줄로 정당화하십시오.
  2. 기존 씬은 사용자의 작업물입니다: 변경 전에 오브젝트, 컬렉션, 모디파이어, 재질을 나열하십시오. 요청하지 않은 것은 이름을 바꾸거나 삭제하지 마십시오. 대량 파괴적 편집 전에는 복사본을 저장하십시오 (save_as_mainfile(copy=True)).
  3. 버전: bpy.app.version_string. API는 5.x에서 변경되었습니다. 코드를 작성하기 전에 references/bpy-api-5x.md에서 확인하십시오.

2. 작업 특성에 맞는 파일만 불러오십시오

작업파일
bpy 스크립트, 자동화, API 오류, MCP vs 헤드리스bpy-api-5x.md
하드 서페이스, 오가닉, 스컬프팅, 리토폴로지, 토폴로지, 모디파이어modeling-topology.md
UV, 텍셀 밀도, 베이킹, PBR, 컬러 스페이스, 텍스처uv-baking-texturing.md
프리미엄 비주얼: 3D 로고, 제품, 재질, 조명, 카메라, 렌더lookdev-render.md
리깅, 웨이트 페인팅, 애니메이션, NLA, 모션 캡처, 클립 내보내기rigging-animation.md
GTA V/FiveM: 포맷, 셰이더, 프롭, 차량, 충돌, LODgta-assets.md
GTA V/FiveM: 맵, MLO 인테리어, ymap/ytyp, ped 의상gta-maps-mlo.md
GTA V/FiveM: ped/오브젝트 애니메이션, YCD, 클립 사전gta-animation.md
Unreal, Unity, Godot, Minecraft, glTF/FBX/USDgame-engines.md
지오메트리 노드, 프로시저럴, 물리, VFXprocedural-sim-vfx.md
폴리곤 예산, LOD, 텍스처, 드로우 콜optimization.md
AI 생성 메시/텍스처/모션 캡처ai-3d-tools.md
여기에 없는 내용을 확인할 곳sources.md

간단한 작업 = 파일 0개 또는 1개. 파이프라인 작업(예: FiveM용 자동차) = 경로 상의 2~3개. 참조 파일에서 ✔ = Blender 5.3 / Sollumz 2.9 코드 / 공식 문서 내부 검사로 확인됨. ✔ 없음 = 확립된 관행이므로, 중요할 경우 확인하십시오. blender-core가 설치되어 있다면 실행(MCP/헤드리스)에 사용하고, 이 스킬은 기준, 파이프라인 및 대상을 위해 사용하십시오.

Blender 찾기 (헤드리스): 실행 중인 프로세스 (Get-Process blender | Select Path), Steam (<Steam>/steamapps/common/Blender/blender.exe), C:\Program Files\Blender Foundation\Blender <버전>\blender.exe, 또는 환경 변수 BLENDER_PATH. 전체 디스크를 뒤지지 마십시오.

3. 항상 유효한 규칙

  • 연산자가 아닌 데이터: bpy.data, bmesh, foreach_get/set. 연산자는 temp_override와 {'FINISHED'} 확인 후에만 사용.
  • 실제 스케일: 1 유닛 = 1 m. 베벨, 거리 기반 모디파이어, 리깅, 물리, 베이킹 및 내보내기 전에 회전/스케일을 적용하십시오.
  • 연산자, 속성, 본 이름, 플래그 또는 셰이더를 임의로 만들지 마십시오. 내부 검사(T.bl_rna.properties, dir(bpy.ops.x)) 또는 문서로 확인하십시오. 확인하지 않았다면 말하십시오.
  • 멱등 스크립트: 두 번 실행해도 오브젝트, 재질, 모디파이어가 중복되지 않아야 합니다(생성 전에 이름으로 검색).
  • 데이터 맵 (러프니스, 메탈릭, 노멀, AO, 마스크) = Non-Color. 색상 = sRGB.
  • Blender 프로시저럴 셰이더는 어떤 엔진으로도 내보내지지 않습니다: 이미지로 베이크하십시오.
  • 내보내기가 '성공'했다고 끝이 아닙니다: 다시 가져오거나 대상에서 열어보십시오.

4. 품질 주기 ('완료' 전 필수)

blender -b scene.blend --python scripts/qa_report.py -- --objects 이름      # 숫자 + 문제점
blender -b scene.blend --python scripts/review_render.py -- --objects 이름 --out C:/tmp/rev.png --shading clay

MCP 사용 시: import sys; sys.path.insert(0, r"<skill>/scripts"); import qa_report; qa_report.run(["이름"]). 로고/프리미엄 제품: scripts/logo_studio.py (오브젝트 복사본이 있는 별도 씬. 자세한 내용은 lookdev-render.md 참조). GTA: scripts/gta_ycd_export.py + scripts/ycdconv.ps1 (애니메이션, gta-animation.md 참조). review_render는 엔진, 해상도, 컬러 매니지먼트, 카메라, 월드 및 재질을 복원합니다(동일 세션에서 두 번 실행하여 헤드리스 테스트 완료).

  1. qa_report 실행 → 문제를 모두 해결하거나 각각을 정당화하십시오.
  2. review_render 실행(형태 확인용 클레이, 마감 확인용 재질) → 이미지를 보고 실루엣, 비율, 음영(이상한 그라데이션 = 노멀 문제), 가장자리 반사를 비판적으로 검토하십시오.
  3. 수정하고 반복하십시오. 시각 작업은 최소 두 번 반복.
  4. 수치 보고: 트라이앵글, 치수(m), 재질, 텍스처(해상도), 생성된 파일과 크기.

5. 마무리할 때

최대 세 줄로 마무리하십시오: 무엇을 어떻게 확인했는지(스크립트, 렌더, 재가져오기, 게임/엔진 내 테스트), 대상에서 테스트하지 않은 것, 그리고 확인되지 않은 것으로 표시된 모든 것.

관련 스킬