游戏引擎 / 系统课时

用 ScriptableObject 存配置

用 ScriptableObject 存配置

多种武器、角色和敌人共用行为,却需要不同数值时,把参数写死在 MonoBehaviour 里会让调参和复用变难。本课以武器为例创建 ScriptableObject 资产,让场景组件只读取配置,独立保存开火次数和冷却状态。

学习目标

  • 创建可在 Inspector 编辑并复用的 ScriptableObject 配置资产。
  • 让 MonoBehaviour 读取共享配置,同时保存独立的运行时状态。
  • 识别资产配置、临时战斗状态和玩家存档的边界。

把固定参数定义成资产类型

ScriptableObject 不是挂到 GameObject 上的行为组件,而是独立于场景对象保存数据的 Unity 对象。用 CreateAssetMenu 声明创建菜单后,可从同一个类生成多份 .asset,例如训练步枪和重型步枪各自引用不同参数。

新建 WeaponConfig.cs:

csharp
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 留在组件上,保证两个武器实例不会共享开火次数和冷却计时。

csharp
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 后):

text
训练步枪:第 1 次开火,伤害 25

数据关系是“一个配置资产被多个组件引用”,而不是“每个组件复制一个配置对象”。只有设计参数共享,各对象的计数和冷却状态才相互独立。

共享武器配置与独立运行时状态的关系

创建资产并运行验证

  1. 等待脚本编译成功,在 Project 窗口执行 Assets > Create > Game > Weapon Config,创建 TrainingRifle.asset。
  2. 在 Inspector 保持 weaponName = 训练步枪、damage = 25、fireInterval = 0.5。
  3. 新建空 GameObject,添加 WeaponController,把 TrainingRifle.asset 拖到组件的 Config 字段。
  4. 进入 Play 模式,查看 Console。Start 会自动调用一次 Fire,其日志应与上面的预期输出一致。

复制这个 GameObject,并让两个组件引用同一资产后,两个实例都会各自输出“第 1 次开火”。停止运行,将资产中的 damage 改为 40 后再次播放,两者读取到的伤害值都会随之变为 40,且无需修改脚本。

不要把共享资产当作运行时存档

多个组件引用同一个 ScriptableObject 资产时,对其可变字段的写入可能影响所有引用方。在 Editor 的 Play 模式中改动资产字段还有保留改动的风险,因此不要把当前生命值、剩余弹药或临时增益直接写回原始配置。需要可变副本时,应明确创建运行时副本并管理其寿命。

ScriptableObject 适合存放设计时可调、运行时多处读取的数据;组件保存每个实体的即时状态,而跨运行会话的持久化记录应使用专门的存档方案。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 ScriptableObject 存配置

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

登录哪都通