游戏引擎 / 系统课时
场景实例如何覆盖模板属性
场景实例如何覆盖模板属性
同一关卡可以复用一个角色场景,却让普通角色与精英角色拥有不同生命值。关键是分清“修改源场景”与“只覆盖某个实例”:前者会传给未覆盖该字段的实例,后者仅保留当前实例自己的值。
学习目标
- 使用
@export让场景根节点属性可在检查器中配置。 - 对比源场景修改前后,继承值与实例覆盖值的变化。
- 恢复实例覆盖,并避免随意编辑场景内部子节点。
给角色模板添加可配置属性
新建 Character.tscn,根节点为 Node2D,命名 Character,可以添加一个 ColorRect 子节点 Body(例如 40 × 40)作为可见占位。将以下完整脚本保存为 character.gd 并挂到根节点:
extends Node2D
class_name ConfigurableCharacter
@export_range(1, 500, 1) var max_hp: int = 100
@export_range(0.0, 400.0, 1.0) var move_speed: float = 120.0
func describe() -> String:
# 输出实例自身生效的值,而不是读取脚本写死的默认数。
return "%s: HP=%d, speed=%.0f" % [str(name), max_hp, move_speed]预期结果:在编辑器中选择 Character 根节点,检查器出现 Max Hp=100 和 Move Speed=120;单独运行模板不会自动打印日志,最终数值由关卡脚本验证。
@export_range 使字段显示在检查器中,并允许编辑器保存数值。脚本中的 100、120.0 是初始默认值;源场景根节点也可以在检查器中另存自己的属性值。运行时应在 _ready() 或更晚读取已经应用的场景实例属性,而不是依赖 _init() 里的导出值。
在关卡上覆盖单个实例
创建 Level.tscn,根节点用 Node2D。把 Character.tscn 从文件系统面板拖入关卡两次,分别重命名为 Guard 和 Tank;可以调整它们的 Position,以便在画面中区分。保持 Guard 的 Max Hp=100 和 Move Speed=120,选择 Tank 的场景实例根节点,仅将 Max Hp 改为 180,不要修改 Character.tscn。
此时 Tank 对应字段旁会出现恢复原值的图标,表示它覆盖了源场景属性。覆盖按字段独立记录:Tank 的速度仍继承源场景,而 Guard 的生命上限和速度都继承源场景。更改一个实例不会反向写回模板。

用运行结果核对覆盖规则
给 Level.tscn 根节点挂载 level.gd。下面的脚本只读取场景实例上已经生效的导出属性,不负责覆盖它们:
extends Node2D
@onready var guard: ConfigurableCharacter = $Guard as ConfigurableCharacter
@onready var tank: ConfigurableCharacter = $Tank as ConfigurableCharacter
func _ready() -> void:
# _ready 阶段读取的是检查器覆盖已经生效的属性。
print(guard.describe())
print(tank.describe())预期输出(源场景仍为 100/120,仅 Tank.max_hp=180):
Guard: HP=100, speed=120
Tank: HP=180, speed=120停止运行,双击打开源文件 Character.tscn,选择其根节点,在检查器中将 Max Hp 改为 120、Move Speed 改为 140,保存。回到 Level.tscn 再运行同一段代码。
预期输出(源场景更新后):
Guard: HP=120, speed=140
Tank: HP=180, speed=140Guard 没有覆盖这两个字段,所以都随源场景变化;Tank 只覆盖生命上限,因此仍为 180,速度则变为 140。这不是复制两份角色配置,而是保存一份模板和少量逐实例差异。

恢复继承并限制内部编辑
在 Level.tscn 里选择 Tank,点击 Max Hp 旁的恢复原值图标。该字段解除实例覆盖后会重新采用当前源场景的 120;再次运行,Tank 应输出 HP=120, speed=140。不要简单把数值手动输入为 120 来代替恢复:应使用恢复操作清除覆盖记录,并以图标状态核对。
默认情况下,场景实例的内部子节点不应成为关卡作者的常规编辑入口。如果确实需要调整实例内部节点,可在场景树中右键实例并启用 Editable Children,但这会使关卡依赖具体子节点结构;一般优先由根节点导出颜色、尺寸等明确需要变化的参数。
验收时检查三个事实:未覆盖字段跟随源场景更新;被覆盖字段保持实例值;恢复原值后再次继承。只有关卡确实需要的差异才应成为实例覆盖,通用行为和内部层级仍留在源场景维护。