Community图像github.com

Blender 游戏套件(代码生成模型)

在 Blender 中通过 Python 脚本构建游戏就绪的 3D 模型——模块化关卡套件(墙体、地板、门洞、楼梯、平台、天花板)、道具和简单角色——将程序化材质烘焙为纹理,生成低成本的 LOD 副本,并导出可直接导入 Unity 或其他引擎的 FBX 文件。

Blender 游戏套件(代码生成模型) 是什么?

这是一个 Blender 智能体技能,旨在让开发者通过 Python 脚本在 Blender 中程序化地生成游戏资产,彻底告别手动建模的重复劳动。它特别适合需要快速迭代的关卡设计、道具生成和角色制作,支持通过 Blender MCP 插件在实时视口中探索效果,也支持无头模式(headless)进行确定性批量导出,确保结果的稳定性和可复现性。技能定义了清晰的工作流:基于网格尺寸设计模块、用辅助函数构建基本体、为每个模块编写单一函数、合并网格以减少 draw call、烘焙程序化材质为纹理(解决 FBX 导出时材质丢失的问题)、以 Unity 轴设置导出 FBX,并自动生成验证文件追踪三角形数量等指标,帮助优化性能。该技能在 Cursor、Claude Code、Codex 等 AI 编码工具中均可使用,当用户需要从 Blender 生成 3D 模型或关卡时,智能体能够自动调用相关脚本。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Maimuzamilhu/claude-code-gamedev-pipeline/tree/HEAD/skills/blender-game-kit

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

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

文档

Blender 游戏套件(代码生成模型) 是做什么的?

通过 Blender 中运行的 Python 脚本构建游戏世界。地牢、房屋、空间站、城市街区:一切都基于网格上的模块加上道具。修改只需编辑代码并重新运行,无需花费数小时重新建模。

示例(《HOLD STILL》):整个两层工厂(墙体、地板、门、楼梯、实验室家具、机器人、残骸)来自大约 20 个 Blender 脚本。

智能体如何运行 Blender

  • 实时 Blender(Blender MCP 插件):在用户已打开的 Blender 中运行 Python,查看视口,搜索并导入 Poly Haven / Sketchfab 资产。最适合探索和检查效果。
  • 无头模式(用于实际导出):blender -b --factory-startup -P build_kit.py。每次运行结果一致,没有 UI 状态污染。用于游戏最终使用的任何内容。

材质节点通过 类型 查找,绝不能通过名称(名称在其他 UI 语言中会被翻译): next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED")。

网格即设计

首先确定模块尺寸,并严格遵守。将其与角色匹配:门洞比玩家胶囊体稍宽、稍高,台阶高度低于角色的最大步高。对于人类大小的角色,这是一个不错的起点(以下是《HOLD STILL》的数值):

部件尺寸
墙体模块宽 4.0 米,厚 0.12 米
地板到天花板高度3.2 米
地板砖2.0 米
门洞1.1 米 × 2.2 米
楼梯踏步0.18 米高度(低于角色步高)

枢轴点位于模块的地板中心,以便在 Unity 中以整数米为单位进行对齐。

工作流程

  1. 先编写辅助函数:box()、cyl()、assign(material)、finish()(应用变换、按角度平滑、UV)。参考 scripts/modular_kit.py,这是一个可用于起步的小型套件。
  2. 每个模块一个函数(build_wall、build_floor、build_doorway)。使用参数实现变体(带/不带排水口、警示条纹、窗户)。
  3. 每个模块一个网格,多材质槽。合并各部件。每个模块变成一个物体和一个纹理集:减少 draw call。
  4. 烘焙 程序化材质(噪点、污垢、凹凸)到 BaseColor、Normal、MetalSmooth(R 通道是金属度,A 通道是光滑度)和 Emission。程序化节点无法在 FBX 导出时保留;不烘焙的话,Unity 只能看到纯色。
  5. 导出 FBX,使用 Unity 的轴设置: axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'。
  6. 导出后写入验证文件:每个模块的三角形数量、边界、材质数量。与上一次运行的结果比较,这样回归问题会以数字形式显现出来。

三角形预算(关键点)

  • 在优化之前先统计三角形的去向。例如,在《HOLD STILL》中,三块天花板砖占了场景中所有三角形的 38.6%,原因是从 2 米下方根本无法看到的 2 毫米倒角。🌐平面减面(按 50 度角溶解近共面面,以 UV 接缝和材质为界)大幅削减了三角形数量,且外观无可见变化。参考 references/budgets.md。
  • 小倒角仅用于近景英雄道具,而不用于重复使用的模块。
  • 对远处或重复使用的部件,创建 _Lite 副本,而不是修改原始套件。

交接至 Unity

  • 导入设置:仅对玩家会接触的部件生成碰撞体;其余部件仅使用简单盒碰撞体。
  • 根据名称将烘焙好的纹理绑定到每个模块的 URP 标准材质上(一个小的编辑器脚本,读取与 FBX 同目录下的 materials.json 文件)。
  • 将 .blend 文件和脚本纳入版本控制。FBX 是构建产物。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能