游戏引擎 / 系统课时
用 ScriptableObject 存配置
用 ScriptableObject 存配置
多种武器、角色和敌人共用行为,却需要不同数值时,把参数写死在 MonoBehaviour 里会让调参和复用变难。本课以武器为例创建 ScriptableObject 资产,让场景组件只读取配置,独立保存开火次数和冷却状态。
学习目标
- 创建可在 Inspector 编辑并复用的 ScriptableObject 配置资产。
- 让 MonoBehaviour 读取共享配置,同时保存独立的运行时状态。
- 识别资产配置、临时战斗状态和玩家存档的边界。
把固定参数定义成资产类型
ScriptableObject 不是挂到 GameObject 上的行为组件,而是独立于场景对象保存数据的 Unity 对象。用 CreateAssetMenu 声明创建菜单后,可从同一个类生成多份 .asset,例如训练步枪和重型步枪各自引用不同参数。
新建 WeaponConfig.cs:
using UnityEngine;
[CreateAssetMenu(fileName = "WeaponConfig", menuName = "Game/Weapon Config")]
public sealed class WeaponConfig : ScriptableObject
{
public string weaponName = "训练步枪";
[Min(0)] public int damage = 25;
[Min(0.01f)] public float fireInterval = 0.5f;
}damage 和 fireInterval 是设计时配置;[Min] 为 Inspector 数值设置最小约束,但不能代替对外部输入的完整校验。角色配置也可使用同样的方法保存基础移动速度、最大生命值;敌人配置则可保存警戒范围和基础伤害,不必把无关字段塞进一个万能资产。
让组件引用配置而不是复制配置
新建 WeaponController.cs。以下代码仅演示读取武器数值和开火冷却,不包含子弹生成或命中结算。shotsFired、nextAllowedTime 留在组件上,保证两个武器实例不会共享开火次数和冷却计时。
using UnityEngine;
public sealed class WeaponController : MonoBehaviour
{
[SerializeField] private WeaponConfig config;
private int shotsFired;
private float nextAllowedTime;
private void Start()
{
if (config == null)
{
Debug.LogError("未指定 WeaponConfig");
enabled = false;
return;
}
// 自动触发一次,便于不接输入系统也能验证配置。
Fire();
}
public void Fire()
{
if (config == null || Time.time < nextAllowedTime) return;
shotsFired++;
nextAllowedTime = Time.time + config.fireInterval;
Debug.Log($"{config.weaponName}:第 {shotsFired} 次开火,伤害 {config.damage}");
}
}预期输出(创建默认值配置资产并绑定到场景组件,进入 Play 后):
训练步枪:第 1 次开火,伤害 25数据关系是“一个配置资产被多个组件引用”,而不是“每个组件复制一个配置对象”。只有设计参数共享,各对象的计数和冷却状态才相互独立。

创建资产并运行验证
- 等待脚本编译成功,在 Project 窗口执行
Assets > Create > Game > Weapon Config,创建TrainingRifle.asset。 - 在 Inspector 保持
weaponName = 训练步枪、damage = 25、fireInterval = 0.5。 - 新建空 GameObject,添加
WeaponController,把TrainingRifle.asset拖到组件的Config字段。 - 进入 Play 模式,查看 Console。
Start会自动调用一次Fire,其日志应与上面的预期输出一致。
复制这个 GameObject,并让两个组件引用同一资产后,两个实例都会各自输出“第 1 次开火”。停止运行,将资产中的 damage 改为 40 后再次播放,两者读取到的伤害值都会随之变为 40,且无需修改脚本。
不要把共享资产当作运行时存档
多个组件引用同一个 ScriptableObject 资产时,对其可变字段的写入可能影响所有引用方。在 Editor 的 Play 模式中改动资产字段还有保留改动的风险,因此不要把当前生命值、剩余弹药或临时增益直接写回原始配置。需要可变副本时,应明确创建运行时副本并管理其寿命。
ScriptableObject 适合存放设计时可调、运行时多处读取的数据;组件保存每个实体的即时状态,而跨运行会话的持久化记录应使用专门的存档方案。