游戏引擎 / 系统课时
为什么两个节点会一起变色
为什么两个节点会一起变色
给一个角色修改 Shader 颜色,另一个角色却同时变色,常见原因不是渲染错误,而是两个节点引用了同一份 ShaderMaterial 资源。本课通过两块色块复现这种联动,再使用材质复制解除共享,并解释不同场景实例和不同节点应该怎样隔离运行时状态。
学习目标
- 解释多个节点共用 ShaderMaterial 时为什么会发生参数联动。
- 使用
duplicate()为节点创建独立材质并验证隔离结果。 - 区分共享 Shader、共享材质以及
resource_local_to_scene的适用范围。
节点独立不代表材质独立
Godot 中的节点和资源具有不同的使用方式。两个 Sprite2D 或 ColorRect 节点可以拥有完全独立的位置、尺寸和可见性,却仍然引用同一个 ShaderMaterial 对象。
当脚本调用 set_shader_parameter() 时,修改发生在 ShaderMaterial 资源上,而不是某个节点自己的参数副本中。因此,只要多个节点使用的是同一材质资源,就可能同时收到这次修改的影响。
需要区分三种关系:
| 资源关系 | 是否可以共享 | 修改后的影响 |
|---|---|---|
| 同一个 Shader 程序 | 可以 | 共享效果逻辑,不要求参数相同 |
| 同一个 ShaderMaterial | 可以 | 修改材质参数会影响所有使用者 |
| 不同 ShaderMaterial 引用同一 Shader | 可以 | 材质参数可以独立修改 |
例如,十个敌人可以共用一套受击闪白 Shader,但每个敌人的受击时间和闪白强度不同。如果直接共用同一个 ShaderMaterial,第一个敌人的受击效果就可能错误地显示在其他敌人身上。

判断是否共享,关键不是节点名字或材质显示名称是否相同,而是两个节点的 material 属性是否引用同一个资源对象。
用一个脚本复现并解除联动
在 Godot 4 中创建一个空的 Node2D 场景,把下面的完整脚本挂到根节点。脚本会自动创建两个 ColorRect,并为它们准备同一个 ShaderMaterial,不需要预先添加子节点或外部 Shader 文件。
运行后先观察共享材质的效果,再观察材质复制后的变化。
extends Node2D
func _ready() -> void:
var shader := Shader.new()
shader.code = """
shader_type canvas_item;
uniform vec4 tint : source_color = vec4(1.0);
void fragment() {
COLOR.rgb *= tint.rgb;
}
"""
var shared_material := ShaderMaterial.new()
shared_material.shader = shader
var left := ColorRect.new()
left.position = Vector2(60, 80)
left.size = Vector2(140, 100)
left.color = Color.WHITE
add_child(left)
var right := ColorRect.new()
right.position = Vector2(250, 80)
right.size = Vector2(140, 100)
right.color = Color.WHITE
add_child(right)
# 两个节点指向同一资源,参数修改同时影响两者。
left.material = shared_material
right.material = shared_material
shared_material.set_shader_parameter("tint", Color(1.0, 0.25, 0.25))
print("共享材质:", left.material == right.material)
await get_tree().create_timer(1.5).timeout
# 复制材质资源,保留Shader程序但隔离参数状态。
var unique_material := shared_material.duplicate() as ShaderMaterial
right.material = unique_material
unique_material.set_shader_parameter("tint", Color(0.2, 0.6, 1.0))
print("材质已隔离:", left.material != right.material)预期输出:
共享材质:true
材质已隔离:true预期画面分为两个阶段。运行后的前 1.5 秒,左右两个色块都显示相同的浅红色。随后右侧色块变成蓝色,左侧仍保持浅红色。
第一阶段能够说明两个节点确实共享一个 ShaderMaterial;第二阶段能够说明复制材质后,右侧对 tint 的修改不会再影响左侧。
脚本中的 Shader.new() 与 ShaderMaterial.new() 用于创建运行时资源。shader.code 提供完整的 CanvasItem Shader 程序,其中 tint 是唯一需要修改的颜色参数。
注意,程序并不是通过创建两个不同的 Shader 来解决问题,而是通过创建两个不同的 ShaderMaterial,让同一 Shader 程序拥有两组独立的参数值。
duplicate 为什么可以隔离参数
duplicate() 是 Godot Resource 提供的复制方法。对 ShaderMaterial 调用它,会创建一个新的材质资源,并复制原材质保存的属性和参数设置。
在本例中,复制操作发生后:
left.material仍引用原来的shared_material。right.material改为引用新的unique_material。- 两份 ShaderMaterial 仍然可以引用同一个 Shader。
- 修改右侧材质的
tint不再改变左侧材质的参数。
默认的 duplicate() 是浅复制,不会无条件复制内部引用的全部子资源。这正适合本例:我们希望 Shader 程序保持共享,只让 ShaderMaterial 的参数状态独立。
这种做法应该发生在角色生成、UI 初始化或效果开始之前,而不是每一帧都重新复制。重复创建大量材质会增加资源数量和管理开销,并可能影响渲染批处理效率。
Local to Scene 能解决哪些共享问题
Godot 的 Resource 还提供 resource_local_to_scene 属性,编辑器中通常显示为 Local to Scene。启用后,当包含该资源的 PackedScene 被实例化时,Godot 可以为不同场景实例创建各自的资源副本。
例如,一个敌人场景只有一个角色 Sprite2D。若其材质启用了 Local to Scene,再创建多个该敌人场景实例,各实例就可以分别修改自己的材质参数。
不过,必须理解它的隔离范围:Local to Scene 主要处理不同场景实例之间的资源隔离,并不保证同一场景实例内部的两个节点自动获得不同材质。
如果一个场景中有两个节点本来就引用同一份材质,启用 Local to Scene 后,它们在同一个场景实例内仍可能引用同一个本地材质副本。需要按节点隔离时,依然可以使用 duplicate() 后分别赋值。
另外,resource_local_to_scene 应在场景实例化之前配置。对已经实例化的资源临时修改这个属性,不会自动重新分配已有节点的材质引用。
怎样选择材质共享策略
实际项目中可以按照运行时状态的归属来选择方案。
| 使用场景 | 推荐策略 |
|---|---|
| 多个背景物体使用完全相同的颜色效果 | 共享 ShaderMaterial |
| 每个敌人有独立的受击闪白强度 | 每个敌人使用独立材质 |
| 同一角色场景被反复实例化 | 预先配置 Local to Scene,或在初始化时复制材质 |
| 同一场景内多个 UI 元素分别改变填充进度 | 为需要独立控制的节点分配不同材质 |
如果观察到多个节点异常联动,建议先验证材质引用是否相同,再检查 Shader 参数。不要只调整 Shader 公式,也不要认为 Node.duplicate() 必然会让所有关联资源自动独立。
还应避免为了隔离参数而盲目复制贴图和 Shader。独立材质通常已经足够,贴图和 Shader 程序仍可共享。对于数量庞大的 3D 对象,也可以根据所用 Godot 版本与渲染器支持情况,评估 Shader 的逐实例参数机制,以减少材质副本数量。
正确的判断标准是:需要同步变化的对象可以共享参数状态;需要独立变化的对象必须拥有独立的参数状态。这样既能避免颜色串联,也能控制不必要的资源开销。