游戏引擎 / 系统课时
Resource 分离配置和运行状态
Resource 分离配置和运行状态
多个角色可以使用同一份生命值与速度模板,但受伤后的血量必须各自变化。本节会创建可在检查器编辑、保存为 .tres 的自定义 Resource,让角色节点读取初始配置并建立独立运行状态,同时判断哪些计算根本不需要节点。
学习目标
- 创建带有导出属性的自定义 Resource,并在检查器中保存和复用配置。
- 使用配置初始化角色实例状态,而不是修改共享模板来记录血量。
- 区分节点、资源与纯计算对象的职责,避免无意义的场景层级。
配置、状态与行为各放哪里
Resource 适合存放角色的设计参数,例如 max_hp 和 move_speed。它可以保存为独立的 .tres 文件,并由多个场景引用;Node 负责接入场景树、生命周期、位置和输入等行为。当前血量、临时加速和冷却倒计时则通常归属于每个运行中的角色实例。
关键区别是可共享的初始规则与不可意外共享的可变状态。加载相同路径的资源通常会得到缓存中的同一个引用;如果把 current_hp 写回该资源,其他引用它的角色就可能读到被修改后的值。

创建可保存的配置资源
在 Godot 4.6 项目中创建 res://character_config.gd。class_name 使资源类型能出现在检查器的资源创建菜单,@export_range 提供可编辑的数值范围;这里的字段只表达初始规则。
class_name CharacterConfig
extends Resource
# 模板保存设计时的初始数值,不保存受伤后的血量。
@export_range(1, 1000, 1) var max_hp: int = 120
@export_range(0.0, 20.0, 0.1) var move_speed: float = 4.5在文件系统面板新建资源,选择 CharacterConfig 类型,保存为 res://hero_config.tres。选中该资源后,可在检查器中调整 Max Hp 与 Move Speed;保存资源即可保留修改。.tres 适合放入版本控制,也能被多个角色引用。
在角色实例中建立运行状态
新建 Node2D 根节点并命名为 Hero,保存为 res://hero.tscn。将下方脚本保存为 res://hero.gd 并附加到根节点。随后在 Hero 的检查器中,把 Config 指向刚创建的 hero_config.tres,保持数值为 120 和 4.5。
extends Node2D
@export var config: CharacterConfig
var current_hp: int
var current_speed: float
func _ready() -> void:
if config == null:
push_error("Hero 缺少 CharacterConfig")
return
# 初始化时读取模板;后续只修改本节点的状态。
current_hp = config.max_hp
current_speed = config.move_speed
current_hp = maxi(0, current_hp - 20)
print("%s: HP %d/%d, speed %.1f" % [
name, current_hp, config.max_hp, current_speed
])预期输出(以 Hero 为当前运行场景的根节点):
Hero: HP 100/120, speed 4.5把 hero.tscn 作为实例放入另一个场景两次,两个节点仍可引用同一份 hero_config.tres,但 current_hp 分别属于各自节点。修改配置后重新运行,新角色会读取新初值;运行中扣血不会写回磁盘上的模板。若需要重生,只需按配置重新初始化运行状态,而不是重新生成配置资源。
不需要场景节点的计算
配置之外还可能有纯规则,例如“扣除非负伤害后,血量不能小于零”。如果计算只依赖传入数字,不需要 _ready()、_process()、位置或子节点,就可写为普通函数,或放进 RefCounted 工具类的静态方法;无需为它添加空的 Node。
不要把所有数据都塞进 Resource:需要频繁变化且只属于单个角色的血量、临时效果一般保留在角色运行状态中;需要编辑器可视化、序列化与复用的初始参数才做成 Resource。这样既能复用设计数据,也不会让资源引用暗中变成角色间的通信通道。