Blender Game Skills Skill 技能

技能简介

Blender Game Skills 是一套面向 Claude Code 等 AI 编程助手的 Agent Skills 技能包，专门用来在 Blender 里生成游戏可直接使用的 3D 资产。项目由开发者 Majid Manzarpour 开源维护，采用 MIT 协议，遵循开放的 SKILL.md 技能标准，因此除 Claude Code 外，其他支持该标准的编码智能体也能加载使用。技能包中每个技能都是一个自包含的文件夹，里面放着指令文档（SKILL.md）、参考笔记（references）、可执行脚本（scripts）和构建模板，智能体按文档分阶段执行并调用脚本完成实际建模。仓库目前内置 blender-image-to-3d 技能，同时预留了持续扩展更多 Blender 技能的目录结构。

核心功能

• 图片转游戏级 3D 资产：把参考图（概念原画、模型三视图、照片、转面图、草图）转换成可入库的游戏资产，覆盖角色、生物、建筑、载具、道具、武器和环境部件。
• 分阶段闸门流程：从需求简报、校准、白模、形体、拓扑、UV 与烘焙、绑定、次级运动、动画、导出到验收，共十余个阶段逐关推进。
• 证据化验收机制：每一关都必须用"与参考图同机位的渲染对比"和"实测数字"来通过，仅凭肉眼观察视口觉得差不多不算数。
• 多引擎导出适配：可按 Unity、Unreal、Godot、three.js 等不同目标引擎的规范输出 GLB、FBX 等格式，并按需生成 LOD 层级与碰撞体。
• 无头脚本自动化：所有脚本以 blender --background --python 无头模式运行，支持 --help，并按节点类型而非显示名称查找节点，兼容非英文界面的 Blender。
• 配套参考与评测：技能目录内置分类规范、交付与验收标准、绑定与动画指南、Blender 5 差异说明，以及用于回归测试的 evals.json 提示词集。

安装配置

• 方式一（推荐，npx 技能 CLI）：npx skills add majidmanzarpour/blender-game-skills --skill blender-image-to-3d -g -a claude-code 全局安装到 ~/.claude/skills/，去掉 -g 则只装进当前项目。
• 方式二（预览不安装）：npx skills add majidmanzarpour/blender-game-skills --list 查看仓库包含哪些技能；--skill '*' 可一次安装全部技能。
• 方式三（手动安装）：git clone 仓库后，把 skills/blender-image-to-3d 文件夹整体复制到 ~/.claude/skills/ 或项目的 .claude/skills/ 目录。
• 环境要求：需要 Node.js 22.20 及以上版本；本机需安装 Blender（开发时在 4.2 与 5.x 上测试）。若技能目录在会话开始后才创建，需重启 Claude Code 才能识别。
• 更新与卸载：npx skills update blender-image-to-3d 更新，npx skills remove blender-image-to-3d 卸载；CLI 默认发送匿名统计，设 DISABLE_TELEMETRY=1 可关闭。

使用步骤

1. 准备参考图：把角色或物体的正面、侧面渲染图（或多视图模型表、概念图）放到项目目录，任意数量图片可在同一条消息里给出。
2. 下达建模指令：在 Claude Code 里附上图片并说明目标，例如"按 ref 目录下骑士的正侧视图，在 Blender 里做一个第三人称动作游戏用角色，约 1.85 米，绑定骨骼，输出 LOD0 到 LOD2"。
3. 逐关推进：智能体按简报→校准→白模→形体→拓扑→UV→烘焙→绑定→动画的顺序推进，每关提交渲染与实测数据等你确认。
4. 核对与迭代：对渲染和参考图逐项比对，发现偏差时让它修改相位脚本里的常量、重建并重复，直到所有误差都落在阶段容差之内。
5. 导出验收：确认达标后导出 GLB/FBX 等目标格式资产，随项目入库。

适用场景

• 独立游戏团队快速把 2D 概念原画变成可进引擎的角色与生物模型。
• 用照片重建石屋、城墙等建筑，并拆成按 2 米网格吸附的模块化套件供 three.js 使用。
• 依据概念图制作可驾驶载具：车轮带轴心枢轴、车门可开、附带碰撞体。
• 把道具草图（如剑）转成低于 3 千三角面、带贴图的游戏道具，直接导出 FBX 给 Unity。
• 为移动端四足动物角色做绑定与行走、奔跑、待机动画，输出单套 1024 贴图的 glTF。

适用人群

独立游戏开发者、技术美术（TA）、使用 Blender 的 3D 建模师、希望用 AI 提效的游戏工作室，以及在 Claude Code 等编码智能体里完成美术管线的全栈开发者。

工作原理

技能以 SKILL.md 承载流程指令与闸门标准，脚本目录存放每个阶段的构建脚本，assets/build_template.py 是脚本模板，references/ 存放分类、验收、绑定动画与 Blender 版本说明。智能体读取 SKILL.md 后按阶段调用 bpy 脚本，无头模式驱动 Blender 完成实际建模；每个闸门用同机位渲染对比和数值测量作为通过证据，误差超容差就修参数重跑。尺寸一律从正交视图测量，透视图只用于轮廓与表面细节；单张图看不到的背面会推断并明确标注。需要说明的是，技能只提供指令与脚本，实际建模质量仍取决于所用模型的能力、参考图质量以及你在各闸门的人工审核。

官方链接

• GitHub 仓库：https://github.com/majidmanzarpour/blender-game-skills
• 技能标准参考：https://agentskills.io
• 作者：Majid Manzarpour（X：@majidmanzarpour）