Communitygithub.com

终极 Blender 技能包

面向 Blender 5.x 的一站式技能,覆盖建模、雕刻、重拓扑/UV、PBR 材质、烘焙、绑定、动画、模拟、VFX、灯光、渲染、游戏导出、产品转盘、Poly Haven、照片转 3D 及 90+ 艺术风格。通过 blender-mcp 或命令行驱动 Blender。

终极 Blender 技能包 是什么?

该技能将三个著名 Blender 技能包——el4cteo(经过测试的 bpy 脚本与 Blender 5.x 规则)、arjun988(技术美术总监工作流,90+ 专业/风格指南)和 kevinbadi(产品相机动画、Poly Haven、Meshy 照片转 3D、Three.js 导出)——融合为一个统一、路由驱动的助手。它提供了一个完整的“分析→计划→简报→执行→验证→交付”总监工作流,确保任何 3D 资产生命周期的高质量。只需一次技能调用,用户即可从建模、雕刻到 UV 映射、PBR 纹理、绑定、动画、VFX、游戏导出(glTF、FBX、USD)和产品可视化,无所不能。该技能通过 blender-mcp(用于实时、逐步执行的 MCP 工具)或通过 shell 命令在无头(后台)模式下运行。它强制遵循 Blender 5.x API 规则(数据 API 优先于操作符,节点按类型查找,枚举安全访问等),并提供 22 个专业指南和一个包含 90 多种艺术风格库的目录。验证是交付前的一个强制步骤,包括自动 QA 脚本、多边形预算检查、截图比较和文件完整性确认。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/i-smiling-buddha/blender-animation-skill/tree/HEAD/skills/ultimate-blender

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

终极 Blender 技能包 是做什么的?

一个技能融合了三个包:el4cteo(经过测试的 bpy 脚本 + Blender 5.x 规则)、arjun988(技术美术总监工作流,90+ 专业和风格指南)以及 kevinbadi(产品相机动画、Poly Haven、Meshy 照片转 3D、Three.js 导出)。

如何使用此文件:首先阅读它,然后仅打开路由表中与任务匹配的一个或多个指南。不要加载所有指南。每个指南都包含来自所有源包的相关章节。所有路径都相对于此技能的文件夹(<skill_root>)。

1. 总监工作流(每个新资产)

分析 → 计划 → 简报 → 执行 → 验证 → 交付
  1. 分析:资产用途(主要/标准/背景)、目标(游戏/电影/作品集/产品视频)、平台(移动/主机/PC/网络/Roblox)、风格、动画(静态/已绑定/动画)、导出格式。
  2. 计划:从路由表(第 4 节)选择指南,并设置多边形和纹理预算(refs/shared/polycount-budgets.md)。
  3. 简报:对于任何大于快速编辑的任务,在接触 Blender 之前编写一个简短的生产简报:资产、预算、使用的指南、阶段、导出目标。
  4. 执行:通过 MCP 或无头模式(第 2 节)运行小步骤。在编写新代码之前,先使用捆绑脚本。
  5. 验证:遵循第 5 节。此步骤是必需的。
  6. 交付:导出,然后报告数字和文件路径。

有参考图像附加? 遵循 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:合成器效果堆栈、VSE EXPAND → RIPPLE。完整表格:refs/blender-core/api-changes-5x.md。代码模式:refs/blender-core/bpy-patterns.md。

4. 路由:任务 → 指南(+ 脚本)

任务打开关键脚本
单位、命名、集合、资产库、批量/无头管线、插件/扩展guides/01-scene-pipeline.mdscene_audit, batch_process, assets/addon_template
硬表面、倒角、布尔运算、加权法线、通用建模、程序化建模guides/02-modeling-hardsurface.mdapply_stack
道具、套件拼接、家具、车辆、机甲、建筑可视化guides/03-props-vehicles-archviz.mdapply_stack, build_pbr_material
雕刻、多分辨率、重新网格化、生物、怪物guides/04-sculpting-creatures.mdsculpt_ops
人类角色、原型、服装、面部绑定、ARKit / 口型同步guides/05-characters-clothing-face.mdgarment, shapekeys
头发、毛发、发卡guides/06-hair-groom.mdgroom
重拓扑、UV 展开、纹素密度、UDIM、光照贴图 UVguides/07-retopology-uv.mdauto_retopo, uv_pack, texel_density
PBR 材质、磨损污渍、贴花、装饰条、烘焙guides/08-materials-texturing-baking.mdbuild_pbr_material, smart_material, decal, bake_maps
几何节点、程序化生成器、散布guides/09-geometry-nodes.mdgn_builder
地形、生物群落、模块化套件、植被、场景布景guides/10-environments-vegetation.mdterrain, scatter, kit_check
Rigify、蒙皮、游戏骨骼、关键帧、NLA、动作捕捉重定向、循环guides/11-rigging-animation.mdrigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check
刚体、布料、流体、破坏、VFX、雨、雪、闪电guides/12-simulation-vfx-weather.mdsim_setup, precipitation, surface_weather, lightning
灯光装置、HDRI、外观开发、相机、一天中的时间、雾、氛围guides/13-lighting-camera-lookdev.mdturntable, scene_mood
Cycles/EEVEE 设置、批量渲染、合成器guides/14-rendering-compositing.mdrender_batch
多边形预算、LOD、绘制调用、碰撞代理guides/15-optimization-lod-collision.mdmesh_stats, make_lods
导出 glTF/FBX/USD 用于 Unity、Unreal、Godot、Roblox、网页/Three.jsguides/16-export-engines.mdexport_asset, node/blender-threejs-export.js
交付前的 QA(始终执行)guides/17-qa-review.mdqa_check, review_shots
视频序列编辑器编辑、运动跟踪、相机解算guides/18-video-editing-tracking.mdvse_edit, track_camera
产品视频:转盘、慢速缩放、推拉、摇臂、变速循环、完美循环、产品抛光guides/19-product-camera-animations.mdnode/blender-product-polish.js, turntable.py
Poly Haven HDRI、纹理、演播室/展示场景、材质变体guides/20-polyhaven-assets.mdnode/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. 验证(在说“完成”之前必须执行)

  1. 报告数字,而非形容词:三角形、对象、材质、尺寸(ob.dimensions)以及写入的输出文件。
  2. 如果几何体发生变化,运行 scripts/qa_check.py(Z 冲突、分离部件、非流形、翻转法线、缩放)。
  3. 查看结果:MCP get_viewport_screenshot / look,或使用无头模式 scripts/review_shots.py 的联系表。
  4. 对于游戏资产,对照平台预算运行 scripts/mesh_stats.py,并检查 refs/shared/validation-checklist.md。
  5. 确认导出的文件存在且大小不为零。

相关技能