在 Godot 4 里更换 3D 模型材质：覆盖槽、GDScript 替换与共享资源的坑

Godot 4 不会把材质存在导入的 GLB 文件里。文件只在导入阶段被读取一次，之后材质要么待在项目内的网格资源上，要么待在场景里的 MeshInstance3D 节点上。分清楚自己改的是哪一处，原本很绕的操作基本几十秒就能做完。

本文按顺序讲四件事：编辑器里的 Surface Material Override 怎么用，运行时用 GDScript 怎么换，StandardMaterial3D 与 ShaderMaterial 各自适合什么场合，以及共享资源为什么会让一次改色波及关卡里所有同款模型。

Godot 4 里模型材质究竟存在哪里

把 GLB、glTF 或 FBX 文件导入 Godot 4 项目时，导入器会生成一个网格资源。文件里描述的材质以表面材质的形式保留在这个网格内部，导出时写了几个材质槽就有几个表面。引用该网格的 MeshInstance3D 节点既能一次性覆盖全部材质，也能只覆盖某一个表面，两种做法都不会改动导入的原始资产。

最终看到什么由三个属性决定，而且它们的优先级是固定的。Material Override 压过其他一切；指定索引的 Surface Material Override 压过该表面自带的材质；网格上的表面材质则是没有任何覆盖时的兜底。这三者都保存在场景里，或者保存在你自己另存的 .tres 资源里，磁盘上的 .glb 永远不会被回写。

编辑器路线：五步把导入模型换成新材质

1. 在场景面板里选中 MeshInstance3D 节点，而不是导入场景的根节点，这样改动属于当前实例，不会落到源资产上。
2. 展开检查器的 Geometry 区域。Material Override 只有一个槽位，Surface Material Override 是数组，先把数组长度设成你要改动的表面数量。
3. 点空槽位并选择新建 StandardMaterial3D，然后展开这个资源，设置 Albedo、Metallic、Roughness 以及各个贴图槽。
4. 从文件系统面板把基础色贴图、法线贴图和 ORM 贴图拖进对应的槽位。
5. 保存场景。覆盖信息会写进场景文件，其他人打开项目看到的就是同样的效果，不需要额外步骤。

不必靠猜也能找到正确的表面索引

场景面板不会列出表面索引，最快的定位办法是给索引 0 挂一个鲜红色的 StandardMaterial3D，然后逐个把索引往上加，直到你要改的部件变红。从 Blender 导出的车身通常带三到六个表面，编号顺序由导出器决定，所以玻璃并不一定在索引 1。导出前先给材质重命名会有帮助，因为材质名会经由 glTF 带进 Godot。

StandardMaterial3D 还是 ShaderMaterial：看你要改什么

StandardMaterial3D 是内置的 PBR 资源，它替你编译成着色器，并把基础色、金属度、粗糙度、法线、环境光遮蔽、自发光、透明和剔除方式暴露成检查器字段，GDScript 里也有同名属性。ShaderMaterial 运行的是用 Godot 着色语言写的代码，凡是标准字段表达不了的效果都得靠它：水面的 UV 滚动、扫描网格上的三平面映射、卡通分层、溶解消失、顶点位移。标准资源搭起来更快，而一旦效果不再是表面属性，着色器资源就是唯一选择。

让参数读起来像真实材质

• 金属度在实际项目里几乎是个开关：木头、皮肤、塑料、布料和喷漆表面保持 0，裸钢、铝和镀铬保持 1。
• 粗糙度承担了大部分观感。常见区间是：抛光镀铬 0.05–0.15，喷漆金属与上漆木材 0.3–0.5，混凝土、橡胶和未处理木材 0.7–0.95。
• 基础色只该带颜色，不该带光照。如果基础色贴图里已经画了阴影，你又接了一张环境光遮蔽贴图，模型在强光下会发灰发脏。
• 法线强度大致在 0.5 到 1.5 之间就能覆盖大多数资产；超过 2 之后，表面看起来更像压花塑料。
• 自发光需要大于 1 的数值，才能在 WorldEnvironment 开启辉光时真正发光；纯白色的自发光照不亮任何东西。

贴图导入设置决定了上面这些能不能留到最后。Godot 4 的贴图导入面板提供 2D、3D、Normal Map 和 Detect 3D 几个预设：基础色与 ORM 贴图用 3D，法线贴图用 Normal Map，这样才能保留法线贴图需要的绿通道处理。如果法线贴图完全没有效果，常见原因是网格缺少切线，而 glTF 导入选项可以生成切线（Godot 4.x 里这个选项叫 Ensure Tangents）。

运行时用 GDScript 更换材质

运行时的替换是搭出受击状态、队伍颜色和选中高亮的常规做法，不必复制整个场景。实例级接口都接收 Material 资源，所以套路是：材质只构建一次，保留引用，状态变化时再赋给节点。两个调用能覆盖大多数情况：material_override 作用于整个节点，set_surface_override_material 配合索引作用于单个部件。每个实例都不一样的数值，例如色调或闪烁相位，可以声明成实例 uniform，再用 set_instance_shader_parameter 设置，不必为此复制材质。

1. 在 _ready() 里构建材质，或者把它做成导出资源，不要写在 _process() 里，否则每帧都在分配资源。
2. 整个道具换材质用 material_override；只有一个部件不同就调用 set_surface_override_material(0, mat)。
3. 把拿到的引用存下来，之后直接改材质属性，不要每帧重新查找节点。
4. 同类物体共用一份材质，再通过实例着色器参数做出差异。

共享资源这个坑，以及三种解法

导入的材质是一份被所有使用它的节点共享的资源。给一个敌人设置 albedo_color，关卡里三十个敌人会一起变色，因为它们背后只有一份材质。Godot 会在检查器里给被多个节点使用的资源加一个小标记，动手改代码之前靠它就能确认问题。

• 在代码里复制：对材质调用 duplicate()，再把副本赋给节点，适合受击染色、每个敌人一种颜色这类状态。
• 给材质打开 Resource > Local to Scene。Godot 会按场景实例自动复制一份，这是手工摆放道具时最省事的做法。
• 材质继续共享，只通过实例着色器参数改变某个数值，用一份材质代替几十份。

第二种做法值得单独提醒一句代价。Local to Scene 会连同资源下面的一切一起复制，所以把它开在网格上而不是材质上，顶点数据也会被复制，场景里每个实例的内存占用都会上升。复制材质很便宜，因为贴图仍按引用共享；复制网格则不便宜。对于来自 AI 生成器或素材包里的资产，先确认关卡里到底摆了多少个副本，再决定要不要走逐实例这条路；这些改动都不会写回源文件。

常见问题

在 Open3DAI 中试一下

把同一份提示词或图片交给多个引擎，并排对比网格，然后导出 GLB、glTF、OBJ、STL、PLY 或 3MF。注册即赠免费积分，无需信用卡。