# Blender

> 채팅에서 실제 Blender로 3D 모델을 만들고 편집합니다. Blender를 찾거나 설치하고, MCP for Blender 추가 기능을 설치한 뒤 프로젝트별로 에이전트에 연결합니다. 소품, 블록아웃, 로우폴리 에셋을 만들어 Unity, Godot 또는 Unreal 프로젝트로 내보내고 미리 보세요.

- Id: `aigd.blender`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 3D
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 1.2.16 (2026-11-22 게시)
- 라이선스: Apache-2.0
- AI Game Dev 앱 필요: `>=0.25.11`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.blender

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

```bash
gamedev pkg add aigd.blender
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.blender`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 1.2.16 | 2026-11-22 | `>=0.25.11` | 최신 |
| 1.2.15 | 2026-11-19 | `>=0.25.11` | - |
| 1.2.14 | 2026-11-13 | `>=0.25.11` | - |
| 1.2.13 | 2026-11-13 | `>=0.25.11` | - |
| 1.2.11 | 2026-11-06 | `>=0.25.11` | - |
| 1.2.10 | 2026-11-01 | `>=0.25.11` | - |
| 1.2.4 | 2026-10-15 | `>=0.18.0` | - |
| 1.2.3 | 2026-10-13 | `>=0.18.0` | - |
| 1.2.2 | 2026-09-30 | `>=0.18.0` | - |

## 설명

````markdown
# Blender (`aigd.blender`)

실제 Blender를 AI Game Dev 에이전트에 연결하여 채팅으로 요청만 하면 3D 모델을 만들고 편집할 수 있습니다. 이 패키지는 컴퓨터에서 Blender를 찾거나 포터블 복사본을 설치하고, MCP for Blender 추가 기능을 설치한 뒤 현재 프로젝트의 에이전트에 연결합니다. Blender에서 소품, 블록아웃, 로우폴리 에셋, 장면 편집을 만들어 Unity, Godot 또는 Unreal 프로젝트에 바로 저장하고 싶은 게임 개발자에게 적합합니다.

## 할 수 있는 작업

- 3D 모델을 요청하면 에이전트가 Blender에서 모델을 만들고, 프로젝트로 내보낸 뒤 앱의 미리보기에 표시합니다.
- Blender 장면에서 오브젝트를 생성, 변경, 삭제하고 재질과 색상을 적용합니다.
- 에이전트가 현재 장면을 검사하고 Blender 내부에서 Python 코드를 실행해 요청에 필요한 작업을 수행하도록 합니다.
- 기존 `.blend` 파일을 열고 에이전트와 함께 계속 작업합니다.
- 언제든지 Blender를 닫을 수 있으며, Blender가 필요한 다음 요청이 들어오면 다시 시작합니다.

## 요청 예시

- "Blender를 사용해 나무 몸체, 어두운 금속 띠, 작은 금색 자물쇠가 있는 로우폴리 보물 상자를 모델링하고, 프로젝트에 .glb로 내보낸 뒤 미리보기에 표시해 주세요."
- "`Art/level-01.blend`을 열고 게이트 근처에 상자 여섯 개와 통 두 개를 추가해 주세요."
- "내 레벨을 위해 약 8m x 6m 크기의 2층 주택을 간단한 블록아웃으로 만들어 주세요."
- "장면의 모든 바위에 이끼 낀 녹색 재질을 적용해 주세요."

## 작동 방식

프로젝트마다 한 번씩 채팅에서 `/blender`을 실행합니다. 그런 다음에는 도구 버튼에서 채팅에 **Blender**를 켤 수 있습니다. 설정:

1. 이 컴퓨터에서 Blender를 찾습니다. 확인 대상은 `BLENDER_BIN`, 앱 자체 다운로드, `PATH`, Steam 라이브러리, 그리고 각 OS의 일반적인 설치 위치(Windows의 Program Files, Microsoft Store 별칭 및 레지스트리, macOS의 `/Applications` 및 Spotlight, Linux의 `/usr/bin`, snap, flatpak 및 `/opt`)입니다. 각 후보는 `blender --version`으로 검사합니다. Blender 4.2 LTS 이상이 필요합니다.
2. 사용 가능한 항목이 없으면 포터블 Blender(5.2.2, Intel Mac에서는 4.5.14. Blender 5.x는 Apple silicon용 macOS로만 제공되기 때문입니다)를 다운로드하며, 고정된 SHA-256으로 검증합니다.
3. 자체 Python을 포함하는 [uv](https://github.com/astral-sh/uv) 0.12.19(고정된 SHA-256)를 다운로드하므로 시스템 Python이 필요 없습니다.
4. [MCP for Blender](https://github.com/ahujasid/blender-mcp)의 추가 기능(`mcp-for-blender` 2.0.4, MIT)을 설치합니다. MCP 서버와 추가 기능은 하나의 고정된 버전에서 제공됩니다.
5. 현재 프로젝트에만 `blender` MCP 서버를 등록한 뒤(Blender는 프로젝트별로 연결됩니다), 포커스를 가져가지 않도록 Blender를 창 뒤에서 엽니다.

추가 기능은 컴퓨터의 9876 포트에서 수신 대기합니다. 업스트림 MCP for Blender는 양방향 통신, 오브젝트 조작, 재질 제어, 장면 검사, Python 코드 실행과 함께 자체 문서에 설명된 에셋 및 모델 통합을 나열합니다.

### `/blender` 명령

| 명령 | 하는 일 |
|---|---|
| `/blender` | Blender를 설정하고 엽니다(Blender를 찾거나 설치하고, 추가 기능을 설치하고, 연결합니다). |
| `/blender setup [options]` | Blender를 열지 않고 설정합니다. `--blender <path>`은 선택한 Blender를 사용하고, `--reinstall`는 추가 기능을 다시 설치하며, `--no-download`은 Blender를 절대 다운로드하지 않고, `--safe`은 Blender 내 에이전트의 Python을 안전한 하위 집합으로 제한합니다. |
| `/blender open [file.blend]` | Blender를 엽니다. 선택적으로 `.blend` 파일과 함께 엽니다. |
| `/blender status` | 설정된 항목과 Blender 연결 여부를 보여 줍니다. |
| `/blender find` | 이 컴퓨터의 모든 Blender를 나열합니다. |
| `/blender remove [--addon] [--files] [--all]` | 에이전트에서 Blender 연결을 해제합니다. `--addon`은 Blender에서 추가 기능도 제거하고, `--files`은 앱이 다운로드한 항목을 삭제하며, `--all`는 둘 다 수행합니다. |

데스크톱 앱은 두 가지 팁도 표시합니다. 하나는 3D 프로젝트에서 도구 버튼으로 Blender를 켜는 방법이고, 다른 하나는 바로 사용할 수 있는 샘플 프롬프트(로우폴리 보물 상자)와 함께 표시되는 "Blender가 준비되었습니다"입니다.

## 요구 사항

- Blender 4.2 LTS 이상, 또는 앱이 포터블 Blender를 다운로드하도록 허용합니다(Windows x64 및 arm64, Apple silicon 및 Intel의 macOS, Linux x64. Linux arm64에는 공식 Blender 빌드가 없습니다).
- 열린 프로젝트: Blender는 프로젝트별로 에이전트에 연결됩니다.
- AI Game Dev 0.25.11 이상.

## 라이선스

이 패키지: Apache-2.0. MCP for Blender(`mcp-for-blender`): MIT. Blender는 Blender Foundation이 GNU GPL에 따라 제공하는 자유 소프트웨어입니다. 패키지 아바타는 공식 Blender 아이콘이며, Blender 상표는 Blender Foundation에 귀속됩니다. 이는 Blender Foundation이 제작하지 않은 타사 통합입니다.
````
