Community이미지github.com

blender-game-kit (코드로 모델 제작)

Blender에서 Python 스크립트로 게임용 모델을 제작합니다. 모듈식 레벨 키트(벽, 바닥, 문, 계단, 플랫폼, 천장), 소품, 간단한 캐릭터를 만들고, 절차적 재질을 텍스처로 베이크하여 FBX로 내보내면 Unity 등 엔진에 바로 사용할 수 있습니다.

blender-game-kit (코드로 모델 제작)란 무엇인가요?

이 스킬은 AI 에이전트가 Blender의 Python API를 활용하여 게임용 3D 모델과 레벨을 코드로 생성하고 내보낼 수 있게 해줍니다. 사용자가 'Blender MCP', '모듈식 키트 만들어 줘', '방/던전/집/복도/소품 모델링', 'Unity로 내보내기', '삼각형 너무 많아' 등으로 요청하면, 에이전트는 미리 정의된 격자(grid) 치수와 모듈 함수를 사용하여 일관된 게임 에셋을 만듭니다. 절차적 재질을 텍스처로 베이크하여 FBX 내보내기 시에도 재질 정보가 유지되며, LOD 버전을 생성하여 삼각형 수를 최적화합니다. 또한 손쉬운 재사용을 위해 내보내기 후 검증 파일을 작성하여 회귀를 방지합니다. Blender MCP 애드온을 통한 실시간 미리보기와 `blender -b` 헤드리스 모드를 통한 최종 내보내기를 모두 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Maimuzamilhu/claude-code-gamedev-pipeline/tree/HEAD/skills/blender-game-kit

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

문서

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에서 정수 미터 단위로 스냅되도록 합니다.

작업 흐름

  1. 먼저 헬퍼 함수부터: box(), cyl(), assign(material), finish() (트랜스폼 적용, 각도 기준 평활화, UV). scripts/modular_kit.py를 참고하세요. 시작하기에 좋은 작은 작업 키트입니다.
  2. 모듈당 하나의 함수 (build_wall, build_floor, build_doorway). 변형을 위한 매개변수(배수구 유무, 위험 줄무늬, 창문 등).
  3. 모듈당 하나의 메시, 여러 개의 재질 슬롯. 부품을 결합하세요. 각 모듈은 하나의 오브젝트와 하나의 텍스처 세트가 되어 드로우 콜을 줄입니다.
  4. 절차적 재질(노이즈, 때, 범프)을 BaseColor, Normal, MetalSmooth (R = 메탈릭, A = 스무드니스) 및 Emission으로 베이크합니다. 절차적 노드는 FBX 내보내기에서 유지되지 않습니다. 베이킹하지 않으면 Unity는 단색만 볼 수 있습니다.
  5. FBX 내보내기는 Unity 축을 사용합니다: axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'.
  6. 내보내기 후 검증 파일을 작성하세요: 모듈별 삼각형 개수, 경계 상자, 재질 개수. 이전 실행 결과와 비교하여 숫자로 회귀를 확인할 수 있습니다.

삼각형 예산 (중요했던 점)

  • 최적화하기 전에 삼각형이 어디에 사용되는지 확인하세요. 예: HOLD STILL에서 세 개의 천장 타일은 장면 전체 삼각형의 38.6%를 차지했는데, 2m 아래에서 아무도 볼 수 없는 2mm 베벨 때문이었습니다. 평면 기반 디시메이트(거의 동일 평면상의 면을 제거, 50도, UV 경계와 재질로 구분)로 눈에 띄는 변화 없이 삼각형 수를 크게 줄였습니다. references/budgets.md 참조.
  • 작은 베벨은 근접 촬영 히어로 소품에만 사용하고, 반복되는 모듈에는 사용하지 마세요.
  • 소스 키트를 수정하는 대신 멀리 있거나 반복되는 부품에는 _Lite 복사본을 만드세요.

Unity로 전달

  • 임포트 설정: 플레이어가 닿는 부품에만 콜라이더를 생성하고, 나머지는 간단한 박스 콜라이더를 사용하세요.
  • 베이크된 텍스처를 모듈 이름별로 URP Lit 재질에 바인딩하세요(FBX 옆에 작성된 materials.json을 읽는 작은 에디터 스크립트 사용).
  • .blend 파일과 스크립트를 버전 관리에 포함하세요. FBX는 빌드 산출물입니다.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬