# 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/zh-hant/packages/aigd.blender

## 安裝

在專案資料夾中，使用 gamedev CLI：

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

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.blender`，然後點 **加入專案**。更多資訊：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`，並在大門附近加上六個木箱和兩個木桶。」
- 「為我的關卡做一個簡單的兩層樓房屋區塊草模，大約 8 乘 6 公尺。」
- 「把場景中每一顆岩石都套上長滿青苔的綠色材質。」

## 運作方式

每個專案在對話中執行一次 `/blender`；之後就能從「工具」按鈕為對話開啟 **Blender**。設定流程：

1. 在這台電腦上尋找 Blender：`BLENDER_BIN`、應用程式自己的下載項目、`PATH`、Steam 媒體庫，以及各作業系統的常見安裝位置（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. 下載 [uv](https://github.com/astral-sh/uv) 0.12.19（固定 SHA-256），它會自帶 Python，因此你不需要系統的 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、macOS 的 Apple silicon 與 Intel、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 製作。
````
