游戏引擎 / 系统课时
处理场景实例之间的数据传递
处理场景实例之间的数据传递
同一个敌人场景可能在关卡里出现多次,但血量、速度和掉落物各不相同。如果把这些差异写死在场景脚本中,就得复制大量场景。本课用 Godot 4 的实例化、参数接口和信号,让关卡配置实例并接收运行反馈。
学习目标
- 区分实例创建前的模板、实例参数与运行时状态。
- 在正确的生命周期阶段向场景实例注入配置。
- 通过信号接收实例事件,验证多个实例互不干扰。
分清初始化数据与运行事件
PackedScene 是可复用的场景模板;调用 instantiate() 得到一份新的节点实例。同一模板可生成斥候和守卫,但它们的最大生命值、移动速度与奖励标识应分别保存在各自实例中。
关卡需要传入的是“这个敌人应该怎样开始”,例如最大血量、速度和奖励 ID;战斗中变化的当前血量属于敌人自身。敌人死亡时通过 defeated 信号回传奖励 ID,而不是在敌人脚本中硬编码关卡节点路径。
关键顺序是先 instantiate(),再调用实例的 configure(),接着连接信号,最后 add_child()。加入已在场景树中的关卡时,实例会进入树并调用 _ready();先注入数据,可保证 _ready() 使用正确的参数。

给实例提供明确的配置接口
先创建 Enemy.tscn,根节点为 Node3D,挂载 enemy.gd。脚本用 configure() 接收必要参数,并在 _ready() 中用这些参数初始化运行状态。
extends Node3D
class_name SpawnEnemy
signal defeated(reward_id: StringName)
var max_hp: int = 1
var speed: float = 0.0
var reward_id: StringName = &""
var hp: int = 0
func configure(new_hp: int, new_speed: float, new_reward: StringName) -> void:
# 配置只写实例字段,不访问尚未进入场景树的子节点。
max_hp = maxi(1, new_hp)
speed = maxf(0.0, new_speed)
reward_id = new_reward
func _ready() -> void:
hp = max_hp
print("%s HP=%d 速度=%.1f 奖励=%s" % [name, hp, speed, str(reward_id)])
func receive_damage(amount: int) -> void:
if amount <= 0 or hp == 0:
return
hp = maxi(0, hp - amount)
if hp == 0:
# 发出语义事件;如何计分或掉落由关卡决定。
defeated.emit(reward_id)
queue_free()再创建 Level.tscn,根节点为 Node3D,挂载 level.gd。在检查器中把 Enemy.tscn 拖到导出的 enemy_scene 字段。以下是与前一脚本共同运行的完整关卡入口:
extends Node3D
@export var enemy_scene: PackedScene
func _ready() -> void:
if enemy_scene == null:
push_error("请在检查器中指定 Enemy.tscn")
return
var scout := spawn_enemy("Scout", 20, 3.0, &"coin")
spawn_enemy("Guard", 60, 1.5, &"key")
if scout != null:
# 模拟一次命中,用于验证死亡事件能传回关卡。
scout.receive_damage(20)
func spawn_enemy(enemy_name: String, hp: int, speed: float, reward: StringName) -> SpawnEnemy:
var enemy := enemy_scene.instantiate() as SpawnEnemy
if enemy == null:
push_error("Enemy.tscn 根节点必须挂 SpawnEnemy 脚本")
return null
# 在 add_child 前配置,确保实例 _ready 读取到正确数值。
enemy.name = enemy_name
enemy.configure(hp, speed, reward)
enemy.defeated.connect(_on_enemy_defeated)
add_child(enemy)
return enemy
func _on_enemy_defeated(reward_id: StringName) -> void:
print("关卡收到奖励:", reward_id)预期输出:
Scout HP=20 速度=3.0 奖励=coin
Guard HP=60 速度=1.5 奖励=key
关卡收到奖励:coin斥候死亡后由 queue_free() 安排释放,守卫仍保持独立的 60 点初始生命值;这说明场景模板可以共享,运行时字段不必共享。实际项目中应让武器或命中系统调用 receive_damage(),而不是在关卡启动时模拟伤害。
将同样的约定用于道具与机关
道具可暴露 configure(item_id, quantity),拾取时发出 collected;机关可接收启动状态和关联标识,触发时发出 activated。接口表示实例需要哪些输入,信号表示实例发生了什么,关卡负责解释结果。不要让道具通过固定绝对路径直接修改背包,也不要让敌人自行寻找奖励 UI。
当不同实例的配置字段增长到十几项时,可以改用自定义 Resource 保存配置组合,但应将当前生命值等可变运行状态留在实例中,避免修改共享资源时影响其他实例。配置从关卡流向实例,结果通过信号返回关卡,是更易扩展的数据边界。