Blender
gamedev pkg add aigd.blender概览
在聊天中于真实的 Blender 里构建和编辑 3D 模型:自动查找或安装 Blender,安装 MCP for Blender 插件,并按项目将其连接到智能体。制作道具、白盒和低多边形资产,导出到你的 Unity、Godot 或 Unreal 项目并预览。
将真实的 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。设置过程:
- 在这台电脑上查找 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 或更新版本。 - 如果都不可用,则下载便携版 Blender(5.2.2;在 Intel Mac 上为 4.5.14,因为 Blender 5.x 仅以 Apple 芯片形式提供 macOS 版本),并对照固定的 SHA-256 进行校验。
- 下载 uv 0.12.19(固定 SHA-256),它自带 Python,因此你无需系统 Python。
- 从 MCP for Blender 安装插件(
mcp-for-blender2.0.4,MIT):MCP 服务器和插件来自同一个固定版本。 - 仅为当前项目注册
blenderMCP 服务器(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 制作。
版本
| 版本 | 发布时间 | 需要应用 |
|---|---|---|
| 1.2.16最新 | 0.25.11 或更高版本 | |
| 1.2.15 | 0.25.11 或更高版本 | |
| 1.2.14 | 0.25.11 或更高版本 | |
| 1.2.13 | 0.25.11 或更高版本 | |
| 1.2.11 | 0.25.11 或更高版本 | |
| 1.2.10 | 0.25.11 或更高版本 | |
| 1.2.4 | 0.18.0 或更高版本 | |
| 1.2.3 | 0.18.0 或更高版本 | |
| 1.2.2 | 0.18.0 或更高版本 |
安装
在桌面应用中安装
打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.blender,然后点击添加到项目。
还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。
从终端安装
在项目文件夹中使用 gamedev CLI:
gamedev pkg add aigd.blender环境要求
- AI Game Dev 0.25.11 或更高版本
gamedev pkg add aigd.blender