# 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-hans/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`，在城门附近添加六个箱子和两个木桶。”
- “为我的关卡做一个简单的两层房屋白盒，大约 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 芯片形式提供 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 芯片和 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 制作。
````
