Blender Game Skills

Blender Game Skills 项目介绍

Blender Game Skills 是一套专为 Claude Code 设计的 Agent 技能，旨在帮助开发者在 Blender 中自动构建游戏就绪的 3D 资产。每个技能都是一个自包含的文件夹，包含指令、参考笔记和脚本，Agent 会按照这些内容执行任务。

核心功能

目前仓库包含一个主要技能 blender-image-to-3d，它能够将参考图像（概念图、模型表、照片、转面图、草图等）转化为游戏可用的 3D 资产，包括角色、生物、建筑、载具、道具、武器和环境部件。整个流程分为多个门禁阶段，从需求简报到最终导出，每个阶段都需通过渲染对比和量化测量来验证。

工作流程与门禁

该技能强调“测量而非目测”，通过以下方式确保质量：

• 分阶段推进：简报 → 校准 → 块面 → 形体 → 拓扑 → UV/烘焙 → 绑定 → 动画 → 导出 → 验收。
• 量化验证：每个阶段结束时，会从与参考图匹配的相机角度渲染，并计算轮廓 IoU、宽度剖面等指标，与参考图对比。
• 自动修正：偏差以具体测量值记录（如“头部高了 12%”），并在构建脚本中修正后重新渲染，直到进入容差范围。
• 导出校验：导出的资产会重新导入空场景，对照清单检查，确保引擎收到的模型与预期一致。

安装与使用

推荐使用 Vercel Labs 的 skills CLI 进行安装（需 Node.js 22.20+）：

# 全局安装单个技能
npx skills add majidmanzarpour/blender-game-skills --skill blender-image-to-3d -g -a claude-code

# 仅当前项目安装
npx skills add majidmanzarpour/blender-game-skills --skill blender-image-to-3d -a claude-code

也可以手动克隆仓库，将 skills/blender-image-to-3d 文件夹复制到 ~/.claude/skills 或项目内的 .claude/skills 目录。

使用示例

在 Claude Code 中附上参考图并描述需求即可，例如：

这是一位骑士的正视图和侧视图（ref/knight_front.png, ref/knight_side.png）。请在 Blender 中为他构建一个游戏就绪的角色，用于 Unity 第三人称动作游戏，身高约 1.85 米，带骨骼，包含 LOD0 到 LOD2。

Agent 会自动识别并调用该技能，也可以使用 /blender-image-to-3d 命令显式触发。

适用场景

• 从概念图快速生成游戏角色、生物、道具等资产。
• 为 Unity、Unreal、Godot 等引擎准备带 LOD 和骨骼的模型。
• 将照片或草图转化为模块化场景组件（如建筑套件）。
• 在 Claude Code 中通过自然语言指令驱动 Blender 建模流程。

注意事项

• 需要预先安装 Claude Code 和 Blender。
• 参考图质量直接影响输出效果，缺失信息会被标记为推断。
• 目前仅包含一个技能，后续可能扩展更多 Blender 相关技能。