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 中以整数米为单位进行对齐。
工作流程
- 先编写辅助函数:
box()、cyl()、assign(material)、finish()(应用变换、按角度平滑、UV)。参考scripts/modular_kit.py,这是一个可用于起步的小型套件。 - 每个模块一个函数(
build_wall、build_floor、build_doorway)。使用参数实现变体(带/不带排水口、警示条纹、窗户)。 - 每个模块一个网格,多材质槽。合并各部件。每个模块变成一个物体和一个纹理集:减少 draw call。
- 烘焙 程序化材质(噪点、污垢、凹凸)到
BaseColor、Normal、MetalSmooth(R 通道是金属度,A 通道是光滑度)和Emission。程序化节点无法在 FBX 导出时保留;不烘焙的话,Unity 只能看到纯色。 - 导出 FBX,使用 Unity 的轴设置:
axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'。 - 导出后写入验证文件:每个模块的三角形数量、边界、材质数量。与上一次运行的结果比较,这样回归问题会以数字形式显现出来。
三角形预算(关键点)
- 在优化之前先统计三角形的去向。例如,在《HOLD STILL》中,三块天花板砖占了场景中所有三角形的 38.6%,原因是从 2 米下方根本无法看到的 2 毫米倒角。🌐平面减面(按 50 度角溶解近共面面,以 UV 接缝和材质为界)大幅削减了三角形数量,且外观无可见变化。参考
references/budgets.md。 - 小倒角仅用于近景英雄道具,而不用于重复使用的模块。
- 对远处或重复使用的部件,创建
_Lite副本,而不是修改原始套件。
交接至 Unity
- 导入设置:仅对玩家会接触的部件生成碰撞体;其余部件仅使用简单盒碰撞体。
- 根据名称将烘焙好的纹理绑定到每个模块的 URP 标准材质上(一个小的编辑器脚本,读取与 FBX 同目录下的
materials.json文件)。 - 将
.blend文件和脚本纳入版本控制。FBX 是构建产物。