Blender 게임 키트 (코드로 모델 제작)
Blender에서 실행되는 Python 스크립트로 게임의 세계를 만듭니다. 던전, 집, 우주 정거장, 도시 블록: 모두 격자 위의 모듈과 소품으로 구성됩니다. 변경 사항은 스크립트를 수정하고 다시 실행하면 되며, 몇 시간씩 다시 모델링할 필요가 없습니다.
예시 (HOLD STILL): 2층짜리 공장 전체(벽, 바닥, 문, 계단, 연구실 가구, 로봇, 잔해)는 약 20개의 Blender 스크립트로 만들어졌습니다.
에이전트가 Blender를 실행하는 방법
- 라이브 Blender (Blender MCP 애드온): 사용자가 열어둔 Blender에서 Python을 실행하고, 뷰포트를 보며 Poly Haven / Sketchfab 에셋을 검색하고 가져옵니다. 탐색 및 외형 확인에 가장 좋습니다.
- 헤드리스 (실제 내보내기용):
blender -b --factory-startup -P build_kit.py. 실행할 때마다 동일한 결과를 얻고 UI 상태가 누출되지 않습니다. 게임에 출시할 때는 이 방식을 사용하세요.
셰이더 노드는 **유형(type)**으로 찾으세요. 이름으로 찾지 마십시오(이름은 다른 UI 언어에서 번역됩니다):
next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED").
격자가 설계의 기본입니다
먼저 모듈 크기를 정하고 절대 변경하지 마세요. 캐릭터에 맞게 조정하세요: 문은 플레이어 캡슐보다 약간 넓고 높게, 계단은 캐릭터의 계단 오름 높이보다 낮게. 인간 크기 캐릭터를 위한 좋은 시작 예시(HOLD STILL의 수치)는 다음과 같습니다:
| 부품 | 크기 |
|---|---|
| 벽 모듈 | 너비 4.0m, 두께 0.12m |
| 바닥에서 천장까지 | 3.2m |
| 바닥 타일 | 2.0m |
| 문 개구부 | 1.1m x 2.2m |
| 계단 높이 | 0.18m (캐릭터의 계단 오름 높이보다 낮게 유지) |
모듈의 바닥 중심에 피벗을 설정하여 Unity에서 정수 미터 단위로 스냅되도록 합니다.
작업 흐름
- 먼저 헬퍼 함수부터:
box(),cyl(),assign(material),finish()(트랜스폼 적용, 각도 기준 평활화, UV).scripts/modular_kit.py를 참고하세요. 시작하기에 좋은 작은 작업 키트입니다. - 모듈당 하나의 함수 (
build_wall,build_floor,build_doorway). 변형을 위한 매개변수(배수구 유무, 위험 줄무늬, 창문 등). - 모듈당 하나의 메시, 여러 개의 재질 슬롯. 부품을 결합하세요. 각 모듈은 하나의 오브젝트와 하나의 텍스처 세트가 되어 드로우 콜을 줄입니다.
- 절차적 재질(노이즈, 때, 범프)을
BaseColor,Normal,MetalSmooth(R = 메탈릭, A = 스무드니스) 및Emission으로 베이크합니다. 절차적 노드는 FBX 내보내기에서 유지되지 않습니다. 베이킹하지 않으면 Unity는 단색만 볼 수 있습니다. - FBX 내보내기는 Unity 축을 사용합니다:
axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'. - 내보내기 후 검증 파일을 작성하세요: 모듈별 삼각형 개수, 경계 상자, 재질 개수. 이전 실행 결과와 비교하여 숫자로 회귀를 확인할 수 있습니다.
삼각형 예산 (중요했던 점)
- 최적화하기 전에 삼각형이 어디에 사용되는지 확인하세요. 예: HOLD STILL에서 세 개의 천장 타일은 장면 전체 삼각형의 38.6%를 차지했는데, 2m 아래에서 아무도 볼 수 없는 2mm 베벨 때문이었습니다. 평면 기반 디시메이트(거의 동일 평면상의 면을 제거, 50도, UV 경계와 재질로 구분)로 눈에 띄는 변화 없이 삼각형 수를 크게 줄였습니다.
references/budgets.md참조. - 작은 베벨은 근접 촬영 히어로 소품에만 사용하고, 반복되는 모듈에는 사용하지 마세요.
- 소스 키트를 수정하는 대신 멀리 있거나 반복되는 부품에는
_Lite복사본을 만드세요.
Unity로 전달
- 임포트 설정: 플레이어가 닿는 부품에만 콜라이더를 생성하고, 나머지는 간단한 박스 콜라이더를 사용하세요.
- 베이크된 텍스처를 모듈 이름별로 URP Lit 재질에 바인딩하세요(FBX 옆에 작성된
materials.json을 읽는 작은 에디터 스크립트 사용). .blend파일과 스크립트를 버전 관리에 포함하세요. FBX는 빌드 산출물입니다.