alla2001/material-painter

项目介绍

Material Painter 是一款把 PBR 材质绘制到 3D 模型上的桌面应用，面向游戏和影视资产美术。它把图层式绘制、网格贴图烘焙和节点式材质编辑放在同一个工具里，底层用 Rust 和 wgpu 实现，许可证为 GPL-3.0。

绘制部分提供绘制层、填充层和文件夹层，支持混合模式、不透明度、笔刷笔尖与纹理颗粒、压感、防抖、对称，以及屏幕、表面或 UV 投影。一个模型包含多个材质时会按材质生成独立纹理集，每个纹理集有自己的图层、尺寸、烘焙贴图和导出文件。智能材质与智能遮罩覆盖边缘磨损、脏污、灰尘、雨痕、滴落、缝隙污垢等常见效果，遮罩还支持色阶、模糊、扭曲、噪波破碎等滤镜。

网格贴图烘焙可生成环境光遮蔽、曲率、缝隙、厚度、法线、高度、位置、世界法线和 ID 等贴图，并支持烘焙笼和按名称匹配。Material Designer 节点图用来驱动填充层和遮罩，Shader Maker 允许用 WGSL 编写自定义节点并提供实时预览和编译器报错，路径工具则把笔刷沿曲线均匀铺开，适合制作缝线、接缝和分件线。导出预设覆盖 Unreal、Unity（URP、HDRP、Built-in）、Godot、glTF、Roblox 和 Blender，也支持自定义通道打包，输出 PNG、TIFF、TGA、JPEG 或 EXR，位深可选 8、16、32 位。

快速使用

可直接运行的版本发布在发布页。Windows 用户使用安装程序，或解压 zip 后运行；Linux 用户解压 tarball 后执行 ./material-painter，也可以运行 ./install.sh 把应用加入应用菜单。

从源码构建需要先通过 rustup 安装稳定版 Rust，然后执行：

git clone https://github.com/alla2001/material-painter
cd material-painter
cargo run --release

cargo test 运行单元测试。GPU 测试在无窗口的离屏环境渲染，并把图像写入 target/bake_test/：

cargo test --bin material_painter -- --ignored --test-threads 1

打开应用后，内置资产库提供约 2,900 个来自 Poly Haven 和 ambientCG 的 CC0 材质，可以先直接开始绘制，无需先导入贴图。

使用约束

Material Painter 运行在 64 位 Windows 10/11，或 glibc 2.35 及以上的 Linux x64（Ubuntu 22.04、Fedora 36、Debian 12 及更新版本），并且需要支持 DirectX 12 或 Vulkan 的 GPU，项目称覆盖 2016 年以后的大部分显卡。4K 纹理集建议 8 GB 显存。项目标注为早期访问版本，并提示可能存在粗糙之处。

导入 Substance 3D Painter（.spp）文件时，会带过模型、纹理集以及 base color、roughness、metallic、height 的最终效果，以及与 Material Painter 图层结构对应的部分图层栈；程序化材质、笔刷笔触和 Painter 独有通道不会导入，导入报告会列出实际带过来的内容。供 AI 代理驱动应用的 MCP 服务器默认关闭。项目与 Adobe 没有隶属关系。

HotRepo 点评

Material Painter 在 2026-11-07 进入 HotRepo 的 Rust 语言新项目榜，在约两小时的统计窗口内新增 5 颗 Star，达到 106 颗 Star 和 7 个 Fork；当天下午的采样记录显示 Star 数从 102 增至 106。观察窗口很短、样本很少，这只能说明项目刚被注意到，不能说明热度能否持续。对一个早期访问工具来说，它的技术范围相当宽：绘制、烘焙、节点图和 WGSL 着色器编写都放在同一个 Rust/wgpu 应用里。新用户最需要留意的是分发方式以预编译安装包和二进制为主，评估时应把发布包与上文的源码构建结果对照核查。