Blender 3D 프로덕션
에셋은 목적지에서 제대로 작동할 때 비로소 완성됩니다: 깨끗한 지오메트리, 실제 스케일, 내보내기 가능한 재질, 측정된 숫자. 뷰포트에서 예뻐도 충분하지 않습니다.
1. 씬을 건드리기 전에
- 대상이 모든 것을 결정합니다: 렌더/제품, GTA/FiveM, Unreal, Unity, Godot, Minecraft, 3D 프린팅. 대상이 정해지지 않았다면 물어보십시오. 이것이 유일한 필수 질문입니다. 나머지는 선택하고 한 줄로 정당화하십시오.
- 기존 씬은 사용자의 작업물입니다: 변경 전에 오브젝트, 컬렉션, 모디파이어, 재질을
나열하십시오. 요청하지 않은 것은 이름을 바꾸거나 삭제하지 마십시오. 대량 파괴적 편집 전에는
복사본을 저장하십시오 (
save_as_mainfile(copy=True)). - 버전:
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: 포맷, 셰이더, 프롭, 차량, 충돌, LOD | gta-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/USD | game-engines.md |
| 지오메트리 노드, 프로시저럴, 물리, VFX | procedural-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는 엔진, 해상도, 컬러 매니지먼트, 카메라, 월드 및 재질을 복원합니다(동일 세션에서 두 번 실행하여 헤드리스 테스트 완료).
qa_report실행 → 문제를 모두 해결하거나 각각을 정당화하십시오.review_render실행(형태 확인용 클레이, 마감 확인용 재질) → 이미지를 보고 실루엣, 비율, 음영(이상한 그라데이션 = 노멀 문제), 가장자리 반사를 비판적으로 검토하십시오.- 수정하고 반복하십시오. 시각 작업은 최소 두 번 반복.
- 수치 보고: 트라이앵글, 치수(m), 재질, 텍스처(해상도), 생성된 파일과 크기.
5. 마무리할 때
최대 세 줄로 마무리하십시오: 무엇을 어떻게 확인했는지(스크립트, 렌더, 재가져오기, 게임/엔진 내 테스트), 대상에서 테스트하지 않은 것, 그리고 확인되지 않은 것으로 표시된 모든 것.