SuperAPI AI 工具集

qwen-mm-plugins-blender

设计与创作

查看项目

更新于 10-16 09:53

技能介绍

用途:在 Blender 中构建或编辑 3D 场景与资产,覆盖建模、角色、建筑室内、地形景观等任务。工作方式是通过 execute_blender_code 工具向运行中的 Blender 实例写入 Python,而不是直接操作界面。

前提:需要一个正在运行、并加载了随插件捆绑的 blender-mcp 插件的 Blender。插件安装下默认预设 QWEN_MM_AUTOLAUNCH=1,首次调用工具会自动安装固定版本 Blender 4.2.x(仅 Linux-x86_64,无 root,约 300MB 一次性下载)并在 $BLENDER_HOST:$BLENDER_PORT(默认 localhost:9876)启动;首次调用可能等一两分钟。不要用 qwen-mm-plugins-blender --launch-app 启动(该入口只在 uvx 环境内)。源码检出下手动/GUI 启动:python3 src/capabilities/blender/qwen_mm_plugins_blender --launch-app(无头,xvfb)或加 --gui。非 Linux-x86_64 需自行安装 Blender;无头机器需 xvfb。

工作流:生成或导入只是第一步,必须精修。分解需求为具体物体、真实尺寸、布局、材质与灯光;选择合适生成器或现成资产(不合适就从头用基本体、修改器、bmesh/几何节点建模);做比例、拓扑、细节、材质、灯光以及物体间关系等深度精修;用渲染或 get_viewport_screenshot 对比需求迭代,最后调用 get_scene_info 确认。

资源:search_sketchfab_models / download_sketchfab_model 获取家具与成品模型;search_polyhaven_assets / download_polyhaven_asset 获取材质、HDRI、道具并用 set_texture 应用;generate_hyper3d_model_via_text / ..._via_images 或 Hunyuan3D 系列生成单个物品,经 poll_rodin_job_status、import_generated_asset 导入。导入生成资产后要检查 world_bounding_box,调整位置、缩放、旋转以免穿模,并按需求继续精修。

插件与扩展:先用 bpy.context.preferences.addons 等方式探查已启用插件,不要凭猜测。Archimesh 用 bpy.ops.mesh.archimesh_room()、.archimesh_door()、.archimesh_window()、.archimesh_stairs()、.archimesh_kitchen();地形用 bpy.ops.mesh.landscape_add(...),若 poll() 报错用 bpy.context.temp_override(...) 包上 VIEW_3D 区域与 WINDOW 区域;重复图案用 bpy.ops.object.tissue_tessellate()。Blender 4.2+ 以扩展安装的 Python API 插件位于 bl_ext.user_default.<id> 命名空间,如 MPFB 的 HumanService.create_human() 只返回身体网格,需自行应用皮肤、眼睛、牙齿等材质并调整比例。无插件时可用几何节点 Distribute Points on Faces + Instance on Points 散布草木碎石,世界背景用 Sky Texture 节点并设 sky_type='NISHITA'。

限制:自动下载仅支持 Linux-x86_64;无头环境需虚拟显示;工具无法连接时通常是这两类原因,错误信息会说明。具体收费、价格与更多平台支持资料暂未提供。