ComfyUI-PBR-Material-Generator 是一款专为 ComfyUI 设计的一体化 PBR(基于物理的渲染)材质生成与预览工具。它彻底摒弃了传统的 AI 模型推理路径,转而采用纯 GPU 着色器数学算法,能够瞬间从单张输入图像中计算出全套 PBR 贴图,并提供基于 Three.js 的交互式实时 3D 预览。该插件完全离线运行,零延迟、零显存负担,是游戏开发者、3D 艺术家及材质设计师提升工作流效率的利器。
- GitHub:https://github.com/aimpowerment/ComfyUI-PBR-Material-Generator

核心亮点:极速、纯粹、离线
- ⚡ 零 AI 依赖,瞬时生成:
- 不加载任何大型 AI 权重或模型,仅通过高效的 GPU 着色器算法处理像素。
- 从单张 IMAGE 输入即可实时生成 6 路标准 PBR 输出:反照率 (Base Color)、深度/高度 (Depth)、法线 (Normal)、粗糙度 (Roughness)、金属度 (Metalness) 及 环境光遮蔽 (AO)。
- 🎨 智能图像处理算法:
- 去光影 (Delight):自动消除原图中的烘焙阴影与高光,还原物体本色。
- 混合法线:融合宏观平滑结构与高频微观细节,支持 OpenGL/DirectX Y 轴翻转。
- 自动金属度提取:基于亮度与色彩饱和度阈值智能识别金属区域。
- 多尺度 AO:基于凹陷与地平线遮蔽算法生成高质量环境光遮蔽。
- 🧊 内置 Three.js 实时 3D 预览:
- 提供 10 种几何体(平面浮雕、立方体、球体、圆柱、圆环结等)即时查看材质效果。
- 支持 9 种开尔文色温灯光预设(从烛光 1900K 到阴天 7500K)及环境照明调节。
- 具备 UV 平铺测试(1x–4x)、边缘平滑位移及线框模式检查功能。
- 💾 一键导出与完全离线:
- 直接导出带有位移细节的 .glb 或 .obj 模型文件,以及高清预览图。
- 本地集成 Three.js 库,运行时无需任何外部 CDN 请求,确保数据隐私与网络无关性。
主要功能详解
| 功能模块 | 详细说明 |
|---|---|
| PBR 贴图生成 | Base Color: 支持去光影强度调节。 Depth: 支持对比度、平滑度及深度反转。 Normal: 支持细节混合比例及 Y 轴翻转。 Roughness/Metalness: 支持基础值、对比度及反转调节。 AO: 基于多尺度算法生成。 |
| 3D 预览交互 | 几何体切换: Plane, Box, Sphere, Cylinder, Cone, Torus, TorusKnot, Capsule, Dodecahedron, Icosahedron。 光照控制: 9 种色温预设,环境背景开关、强度及模糊调节。 视图检查: 单独查看各通道贴图,支持深色/青铜悬浮画框。 |
| 自定义输入 | 可选接入外部 Height, Normal, Roughness, Metalness, AO 贴图或 HDR/EXR 环境贴图,直接在预览器中打光测试。 |
| 导出能力 | 一键导出烘焙后的 .glb / .obj 模型,或复制当前材质配置参数。 |
快速开始
1. 安装
- 推荐方式 (ComfyUI Manager):
- 打开 ComfyUI Manager → Custom Nodes Manager。
- 搜索
ComfyUI PBR Material Generator并点击 Install。 - 重启 ComfyUI 并强制刷新浏览器 (
Ctrl + Shift + R)。
- 手动安装:
cd ComfyUI/custom_nodes git clone https://github.com/aimpowerment/ComfyUI-PBR-Material-Generator.git # 重启 ComfyUI 并刷新浏览器
2. 使用流程
- 右键画布 →
Add Node→3D/Preview→PBR Material Generator。 - 将任意图像连接到节点的
image输入端口。 - 点击
Run(或直接观察,部分实现为实时响应)。 - 使用节点右上角的 交互式 HUD 实时调节位移深度、法线强度、粗糙度、金属度等参数。
- 使用底部工具栏切换 3D 几何体、查看单通道贴图、调整光照色温或测试 UV 平铺。
- 满意后,点击导出按钮获取 .glb/.obj 模型或截图。
适用场景
- 游戏资产快速原型:从概念图瞬间生成可交互的 3D 材质球。
- 电商产品展示:将产品平面图快速转化为具有真实光影效果的 3D 展示模型。
- 材质库构建:批量处理图片生成标准化的 PBR 贴图组。
- 教学与演示:直观展示不同 PBR 参数对材质视觉效果的影响。
ComfyUI-PBR-Material-Generator 以其独特的“无 AI”技术路线,为 ComfyUI 生态填补了高性能、低门槛 PBR 工作流的空白,让材质创作变得前所未有的简单与高效。
© 版权声明
文章版权归作者所有,未经允许请勿转载。













