游戏引擎 / 系统课时

为什么两个节点会一起变色

为什么两个节点会一起变色

给一个角色修改 Shader 颜色,另一个角色却同时变色,常见原因不是渲染错误,而是两个节点引用了同一份 ShaderMaterial 资源。本课通过两块色块复现这种联动,再使用材质复制解除共享,并解释不同场景实例和不同节点应该怎样隔离运行时状态。

学习目标

  • 解释多个节点共用 ShaderMaterial 时为什么会发生参数联动。
  • 使用 duplicate() 为节点创建独立材质并验证隔离结果。
  • 区分共享 Shader、共享材质以及 resource_local_to_scene 的适用范围。

节点独立不代表材质独立

Godot 中的节点和资源具有不同的使用方式。两个 Sprite2D 或 ColorRect 节点可以拥有完全独立的位置、尺寸和可见性,却仍然引用同一个 ShaderMaterial 对象。

当脚本调用 set_shader_parameter() 时,修改发生在 ShaderMaterial 资源上,而不是某个节点自己的参数副本中。因此,只要多个节点使用的是同一材质资源,就可能同时收到这次修改的影响。

需要区分三种关系:

资源关系 是否可以共享 修改后的影响
同一个 Shader 程序 可以 共享效果逻辑,不要求参数相同
同一个 ShaderMaterial 可以 修改材质参数会影响所有使用者
不同 ShaderMaterial 引用同一 Shader 可以 材质参数可以独立修改

例如,十个敌人可以共用一套受击闪白 Shader,但每个敌人的受击时间和闪白强度不同。如果直接共用同一个 ShaderMaterial,第一个敌人的受击效果就可能错误地显示在其他敌人身上。

ShaderMaterial共享与材质实例隔离对比

判断是否共享,关键不是节点名字或材质显示名称是否相同,而是两个节点的 material 属性是否引用同一个资源对象。

用一个脚本复现并解除联动

在 Godot 4 中创建一个空的 Node2D 场景,把下面的完整脚本挂到根节点。脚本会自动创建两个 ColorRect,并为它们准备同一个 ShaderMaterial,不需要预先添加子节点或外部 Shader 文件。

运行后先观察共享材质的效果,再观察材质复制后的变化。

gdscript
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)

预期输出:

text
共享材质: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 的逐实例参数机制,以减少材质副本数量。

正确的判断标准是:需要同步变化的对象可以共享参数状态;需要独立变化的对象必须拥有独立的参数状态。这样既能避免颜色串联,也能控制不必要的资源开销。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为什么两个节点会一起变色

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通