终极 Blender 技能包 是做什么的?
一个技能融合了三个包:el4cteo(经过测试的 bpy 脚本 + Blender 5.x 规则)、arjun988(技术美术总监工作流,90+ 专业和风格指南)以及 kevinbadi(产品相机动画、Poly Haven、Meshy 照片转 3D、Three.js 导出)。
如何使用此文件:首先阅读它,然后仅打开路由表中与任务匹配的一个或多个指南。不要加载所有指南。每个指南都包含来自所有源包的相关章节。所有路径都相对于此技能的文件夹(<skill_root>)。
1. 总监工作流(每个新资产)
分析 → 计划 → 简报 → 执行 → 验证 → 交付
- 分析:资产用途(主要/标准/背景)、目标(游戏/电影/作品集/产品视频)、平台(移动/主机/PC/网络/Roblox)、风格、动画(静态/已绑定/动画)、导出格式。
- 计划:从路由表(第 4 节)选择指南,并设置多边形和纹理预算(
refs/shared/polycount-budgets.md)。 - 简报:对于任何大于快速编辑的任务,在接触 Blender 之前编写一个简短的生产简报:资产、预算、使用的指南、阶段、导出目标。
- 执行:通过 MCP 或无头模式(第 2 节)运行小步骤。在编写新代码之前,先使用捆绑脚本。
- 验证:遵循第 5 节。此步骤是必需的。
- 交付:导出,然后报告数字和文件路径。
有参考图像附加? 遵循 refs/shared/reference-image-match.md:填写 refs/shared/reference-analysis-template.md,在微细节之前匹配相机,在截图比较上循环,然后对照 refs/shared/visual-match-checklist.md 检查。
完整的总监手册,包括简报、多技能配方和决策树:refs/director-full.md。
命名:refs/shared/naming-conventions.md · 管线:refs/shared/asset-pipeline.md · MCP:refs/shared/mcp-integration.md、refs/shared/mcp-tools.md。
2. 执行
实时(blender-mcp execute_blender_code):分小步骤工作,只打印你需要的内容。调用捆绑脚本:
import sys, importlib; sys.path.insert(0, r"<skill_root>/scripts")
import qa_check; importlib.reload(qa_check); print(qa_check.run(objects=["Chair"]))
每次 MCP 调用都在一个新的命名空间中运行,因此每次都要重新 import。仅编辑脚本后使用 reload。
无头模式(shell,无需 MCP)。这仅打印脚本的 JSON:
python <skill_root>/scripts/run_in_blender.py --blend in.blend <skill_root>/scripts/<script.py> -- --objects Chair --save out.blend
python <skill_root>/scripts/run_in_blender.py --expr "import bpy; print(len(bpy.data.objects))"
Windows:推荐使用 PowerShell。在 Git Bash 中,添加前缀 MSYS_NO_PATHCONV=1 并使用 $(cygpath -m ~/.claude/skills)/ultimate-blender/...。blender.exe 必须在 PATH 中,或者传递其路径。
会话中的首次调用:运行 scripts/env_report.py(版本、引擎、GPU、插件、单位、色彩管理)。
Node 辅助工具(kevinbadi;它们通过端口 9876 与 blender-mcp 通信):node <skill_root>/scripts/node/<name>.js --help。
3. Blender 5.x 规则(这些规则覆盖任何指南中的旧建议)
- 数据 API 优先于操作符:使用
bpy.data、bmesh、mesh.attributes以及结合 numpy 的foreach_get/set。操作符需要上下文,且后台模式没有 3D 视图。 - 不可避免的操作符:
with bpy.context.temp_override(object=ob, active_object=ob, selected_objects=[ob], selected_editable_objects=[ob]): bpy.ops...,然后检查{'FINISHED'}。 - 编辑模式:在编辑模式下,
ob.data是过时的。使用bmesh.from_edit_mesh+update_edit_mesh,或先切换到 OBJECT 模式。 - 节点:通过
type("BSDF_PRINCIPLED")查找节点,永远不要通过name,因为名称是本地化的。 - 枚举:从
bl_rna.properties[p].enum_items读取它们。对于动态枚举(render.engine、view_transform),在try/except TypeError内赋值。 - 引擎:
BLENDER_EEVEE、CYCLES、BLENDER_WORKBENCH。GPU:scene.cycles.device="GPU"+ 首选项中的compute_device_type。 - 计算网格:
ob.evaluated_get(dg).to_mesh(),然后始终to_mesh_clear()。在读取matrix_world之前调用view_layer.update()。 - 已释放数据:在移除或应用任何内容之前收集名称,并且永远不要重用旧的 Python 引用。
- 名称:永远不要信任 "Cube.001"。显式重命名并使用
bpy.data.objects[name]查找对象。 - 规模:1 单位 = 1 米。在倒角、绑定、物理、烘焙和导出之前应用旋转和缩放。
- 实时会话是用户的工作:永远不要
read_factory_settings,永远不要删除不是你创建的数据,并在破坏性批量编辑之前保存备份(save_as_mainfile(copy=True))。 - 后台 GPU:调用
gpu.init()(5.2+)。bgl不再存在。雕刻模式在-b中会崩溃,因此使用scripts/sculpt_ops.py。 - 5.x API 中断:
action.fcurves→ channelbags ·scene.node_tree→scene.compositing_node_group·material.use_nodes已弃用 ·mod["Socket_2"]→mod.properties.inputs.Socket_2.value·BLENDER_EEVEE_NEXT→BLENDER_EEVEE· 布尔FAST→FLOAT· 骨骼图层 → 骨骼集合 ·bl_info→blender_manifest.toml· 5.3:合成器效果堆栈、VSEEXPAND→RIPPLE。完整表格:refs/blender-core/api-changes-5x.md。代码模式:refs/blender-core/bpy-patterns.md。
4. 路由:任务 → 指南(+ 脚本)
| 任务 | 打开 | 关键脚本 |
|---|---|---|
| 单位、命名、集合、资产库、批量/无头管线、插件/扩展 | guides/01-scene-pipeline.md | scene_audit, batch_process, assets/addon_template |
| 硬表面、倒角、布尔运算、加权法线、通用建模、程序化建模 | guides/02-modeling-hardsurface.md | apply_stack |
| 道具、套件拼接、家具、车辆、机甲、建筑可视化 | guides/03-props-vehicles-archviz.md | apply_stack, build_pbr_material |
| 雕刻、多分辨率、重新网格化、生物、怪物 | guides/04-sculpting-creatures.md | sculpt_ops |
| 人类角色、原型、服装、面部绑定、ARKit / 口型同步 | guides/05-characters-clothing-face.md | garment, shapekeys |
| 头发、毛发、发卡 | guides/06-hair-groom.md | groom |
| 重拓扑、UV 展开、纹素密度、UDIM、光照贴图 UV | guides/07-retopology-uv.md | auto_retopo, uv_pack, texel_density |
| PBR 材质、磨损污渍、贴花、装饰条、烘焙 | guides/08-materials-texturing-baking.md | build_pbr_material, smart_material, decal, bake_maps |
| 几何节点、程序化生成器、散布 | guides/09-geometry-nodes.md | gn_builder |
| 地形、生物群落、模块化套件、植被、场景布景 | guides/10-environments-vegetation.md | terrain, scatter, kit_check |
| Rigify、蒙皮、游戏骨骼、关键帧、NLA、动作捕捉重定向、循环 | guides/11-rigging-animation.md | rigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check |
| 刚体、布料、流体、破坏、VFX、雨、雪、闪电 | guides/12-simulation-vfx-weather.md | sim_setup, precipitation, surface_weather, lightning |
| 灯光装置、HDRI、外观开发、相机、一天中的时间、雾、氛围 | guides/13-lighting-camera-lookdev.md | turntable, scene_mood |
| Cycles/EEVEE 设置、批量渲染、合成器 | guides/14-rendering-compositing.md | render_batch |
| 多边形预算、LOD、绘制调用、碰撞代理 | guides/15-optimization-lod-collision.md | mesh_stats, make_lods |
| 导出 glTF/FBX/USD 用于 Unity、Unreal、Godot、Roblox、网页/Three.js | guides/16-export-engines.md | export_asset, node/blender-threejs-export.js |
| 交付前的 QA(始终执行) | guides/17-qa-review.md | qa_check, review_shots |
| 视频序列编辑器编辑、运动跟踪、相机解算 | guides/18-video-editing-tracking.md | vse_edit, track_camera |
| 产品视频:转盘、慢速缩放、推拉、摇臂、变速循环、完美循环、产品抛光 | guides/19-product-camera-animations.md | node/blender-product-polish.js, turntable.py |
| Poly Haven HDRI、纹理、演播室/展示场景、材质变体 | guides/20-polyhaven-assets.md | node/polyhaven-*.js |
照片 → 纹理化 3D 模型(Meshy API,需要 MESHY_API_KEY) | guides/21-image-to-3d.md | 然后 auto_retopo, qa_check |
| 端到端操作手册(道具、角色、Roblox、产品镜头) | guides/22-workflow-recipes.md | |
| 可选外部 WebSocket 工具包(通过 Dev-GOM 插件进行 Mixamo 重定向) | guides/23-websocket-toolkit.md | (未捆绑) |
风格方向:从这些文件中打开一个部分,而不是整个文件。
| 风格需求 | 打开 |
|---|---|
| 风格化、写实、低多边形、动漫/漫画、Q版、卡通、漫画、手绘、像素风、体素风、等距、HD-2D、复古 8/16 位、黑色电影、卡通/NPR、主机世代(PS1–PS5、CRT/VHS) | styles/art-styles.md |
| 恐怖、PSX 恐怖、独立、伪纪录片、身体恐怖、宇宙恐怖、民俗恐怖、吉祥物恐怖、阈限空间、怪核 | styles/horror.md |
| 奇幻、科幻/朋克、末世、历史、生物群落、舒适、黑暗/粗犷、超现实、粗野主义、霓虹未来主义 | styles/worlds-moods.md |
| 类型艺术指导:动作、卡牌/放置、类银河城、视觉小说、开放世界、平台游戏、赛车、RPG、射击、魂系、潜行、策略、生存 | styles/game-genres.md |
按主题的深度参考存放在 refs/<原始技能名>/ 中,指南直接链接到它们。
5. 验证(在说“完成”之前必须执行)
- 报告数字,而非形容词:三角形、对象、材质、尺寸(
ob.dimensions)以及写入的输出文件。 - 如果几何体发生变化,运行
scripts/qa_check.py(Z 冲突、分离部件、非流形、翻转法线、缩放)。 - 查看结果:MCP
get_viewport_screenshot/look,或使用无头模式scripts/review_shots.py的联系表。 - 对于游戏资产,对照平台预算运行
scripts/mesh_stats.py,并检查refs/shared/validation-checklist.md。 - 确认导出的文件存在且大小不为零。