Godot 4：如何为场景中多个节点添加独立的着色器实例？

问题根源分析 #

你的代码出现多个对象轮廓同步变化或只有单个对象生效的情况，大概率是以下两个原因之一：

• Shader的uniform参数被标记为全局共享：如果你的轮廓Shader中，color参数使用了global uniform声明，所有使用该Shader的材质会共享这个参数值，修改一个对象的参数就会影响所有对象。
• 多个对象共享同一个Sprite2D节点：如果导出变量interactable_sprite被多个InteractableBody实例设置为同一个Sprite2D节点，修改该Sprite的材质参数会同步影响所有关联对象。

修复步骤 #

1. 检查并修改Shader代码 #

打开你的轮廓Shader，确保color参数是普通uniform，而非全局共享：

// 错误写法（全局共享）
global uniform vec4 color;

// 正确写法（每个材质实例独立）
uniform vec4 color;

2. 确保每个对象使用独立的Sprite2D #

在编辑器中检查每个InteractableBody实例的interactable_sprite导出变量，确保它们指向各自独立的Sprite2D子节点，不要共享同一个Sprite资源。

3. 优化代码，缓存材质实例 #

修改InteractableBody代码，提前缓存ShaderMaterial实例，避免重复获取和类型转换，同时优化性能：

class_name InteractableBody
extends CharacterBody2D

@export var string_name : String
@export var icon : Texture2D
@export var interact_range : float
@export var interactable_sprite : Sprite2D
@export var outline_shader : Shader

var player_node : Player = null
var shader_material : ShaderMaterial # 缓存材质实例

func _ready():
    add_to_group("interactable")
    shader_material = ShaderMaterial.new()
    shader_material.shader = outline_shader
    interactable_sprite.set_material(shader_material)
    hide_outline()

func setup_player(_player_node):
    if _player_node:
        player_node = _player_node

func _process(delta):
    if player_node:
        # 用平方距离判断，提升性能
        var distance_squared = player_node.global_position.distance_squared_to(global_position)
        var range_squared = interact_range * interact_range
        if distance_squared < range_squared:
            if not player_node.interactable_objects.has(self):
                show_outline()
                player_node.add_interactable(self)
        else:
            if player_node.interactable_objects.has(self):
                hide_outline()
                player_node.remove_interactable(self)

func show_outline():
    shader_material.set_shader_parameter("color", Color(1.0, 1.0, 1.0, 1.0))

func hide_outline():
    shader_material.set_shader_parameter("color", Color(1.0, 1.0, 1.0, 0.0))

4. 验证Player类的集合管理 #

检查Player类的add_interactable和remove_interactable方法，确保它们正确维护interactable_objects集合，比如：

# Player类示例代码
var interactable_objects = []

func add_interactable(obj):
    if obj not in interactable_objects:
        interactable_objects.append(obj)

func remove_interactable(obj):
    if obj in interactable_objects:
        interactable_objects.remove(obj)

这样修改后，每个可交互对象的轮廓就能独立开关，不会出现同步变化或单个对象生效的问题。

内容的提问来源于stack exchange，提问作者Logan Brunner