游戏引擎 / 系统课时

场景实例如何覆盖模板属性

场景实例如何覆盖模板属性

同一关卡可以复用一个角色场景,却让普通角色与精英角色拥有不同生命值。关键是分清“修改源场景”与“只覆盖某个实例”:前者会传给未覆盖该字段的实例,后者仅保留当前实例自己的值。

学习目标

  • 使用 @export 让场景根节点属性可在检查器中配置。
  • 对比源场景修改前后,继承值与实例覆盖值的变化。
  • 恢复实例覆盖,并避免随意编辑场景内部子节点。

给角色模板添加可配置属性

新建 Character.tscn,根节点为 Node2D,命名 Character,可以添加一个 ColorRect 子节点 Body(例如 40 × 40)作为可见占位。将以下完整脚本保存为 character.gd 并挂到根节点:

gdscript
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 的生命上限和速度都继承源场景。更改一个实例不会反向写回模板。

Godot 场景实例导出属性覆盖与还原位置

用运行结果核对覆盖规则

给 Level.tscn 根节点挂载 level.gd。下面的脚本只读取场景实例上已经生效的导出属性,不负责覆盖它们:

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

text
Guard: HP=100, speed=120
Tank: HP=180, speed=120

停止运行,双击打开源文件 Character.tscn,选择其根节点,在检查器中将 Max Hp 改为 120、Move Speed 改为 140,保存。回到 Level.tscn 再运行同一段代码。

预期输出(源场景更新后):

text
Guard: HP=120, speed=140
Tank: HP=180, speed=140

Guard 没有覆盖这两个字段,所以都随源场景变化;Tank 只覆盖生命上限,因此仍为 180,速度则变为 140。这不是复制两份角色配置,而是保存一份模板和少量逐实例差异。

角色模板修改后两个实例的属性继承与覆盖关系

恢复继承并限制内部编辑

在 Level.tscn 里选择 Tank,点击 Max Hp 旁的恢复原值图标。该字段解除实例覆盖后会重新采用当前源场景的 120;再次运行,Tank 应输出 HP=120, speed=140。不要简单把数值手动输入为 120 来代替恢复:应使用恢复操作清除覆盖记录,并以图标状态核对。

默认情况下,场景实例的内部子节点不应成为关卡作者的常规编辑入口。如果确实需要调整实例内部节点,可在场景树中右键实例并启用 Editable Children,但这会使关卡依赖具体子节点结构;一般优先由根节点导出颜色、尺寸等明确需要变化的参数。

验收时检查三个事实:未覆盖字段跟随源场景更新;被覆盖字段保持实例值;恢复原值后再次继承。只有关卡确实需要的差异才应成为实例覆盖,通用行为和内部层级仍留在源场景维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

场景实例如何覆盖模板属性

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

登录哪都通