游戏引擎 / 系统课时

用 ScriptableObject 配置武器

用 ScriptableObject 配置武器

为木剑和重锤分别编写攻击脚本,会让伤害、距离与冷却逻辑不断重复。本课把四项武器参数放进 ScriptableObject 资产,由同一个近战组件读取。完成后只需切换资产引用,就能验证两种武器的差异,同时保证每个角色的冷却计时独立。

学习目标

  • 建立可复用的 WeaponConfig 资产,配置伤害、攻击范围、冷却和动画触发名。
  • 让同一个 WeaponAttack 组件读取不同武器配置,不把运行时状态写入资产。
  • 在 Unity 6 场景中测试两种武器的命中伤害、距离和冷却。

定义武器配置资产

在 Assets/Scripts/Combat/WeaponConfig.cs 新建脚本。ScriptableObject 不挂在 GameObject 上;通过 CreateAssetMenu,可直接在 Project 窗口创建 .asset 文件。[SerializeField] 让私有字段可在 Inspector 编辑,只读属性供战斗代码读取。

csharp
using UnityEngine;

[CreateAssetMenu(fileName = "WeaponConfig", menuName = "Combat/Weapon Config")]
public sealed class WeaponConfig : ScriptableObject
{
    // 共享资产只保存武器定义,不保存当前冷却或连击进度。
    [SerializeField, Min(1)] private int damage = 12;
    [SerializeField, Min(0.1f)] private float attackRange = 2f;
    [SerializeField, Min(0.01f)] private float cooldownSeconds = 0.35f;
    [SerializeField] private string attackTrigger = "LightAttack";

    public int Damage => damage;
    public float AttackRange => attackRange;
    public float CooldownSeconds => cooldownSeconds;
    public string AttackTrigger => attackTrigger;
}

预期结果:编译无误后,在 Project 窗口右键选择 Create > Combat > Weapon Config,可创建具有四个可编辑字段的武器资产。新建 Assets/GameData/Weapons 文件夹,建立并重命名两份资产,填写以下参数:

资产名 Damage Attack Range Cooldown Seconds Attack Trigger
TrainingSword 12 2.0 0.35 LightAttack
HeavyHammer 32 2.8 0.95 HeavyAttack

距离单位为米,冷却单位为秒。Attack Trigger 存放 Animator 的 Trigger 参数名,而不是动画片段文件名;只有 Animator Controller 配置了同名参数和状态转换,调用它才会驱动对应动作。

用同一攻击组件消耗配置

武器资产提供固定参数,角色上的 WeaponAttack 保存 nextAttackTime。即使两名角色引用同一把武器的资产,也必须各自计算冷却。示例按空格触发攻击,用球形重叠查询搜索目标,再限制为角色正前方约 120°;对同一目标的多个 Collider 只结算一次。

共享武器配置、攻击组件和独立冷却的数据流

新建 Assets/Scripts/Combat/WeaponAttack.cs。本示例使用 Unity 的 Input System 包(UnityEngine.InputSystem);如果尚未安装,在 Window > Package Manager 的 Unity Registry 中安装 Input System,并将 Edit > Project Settings > Player > Active Input Handling 设为 Input System Package (New) 或 Both,按提示重启编辑器。

csharp
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.InputSystem;

public sealed class WeaponAttack : MonoBehaviour
{
    [SerializeField] private WeaponConfig weapon;
    [SerializeField] private Animator animator;
    [SerializeField] private LayerMask targetLayers;

    private float nextAttackTime;
    private readonly HashSet<HealthTarget> processedTargets = new HashSet<HealthTarget>();

    private void Update()
    {
        if (Keyboard.current != null && Keyboard.current.spaceKey.wasPressedThisFrame)
            TryAttack();
    }

    public void TryAttack()
    {
        if (weapon == null || Time.time < nextAttackTime) return;

        // 冷却计时只修改角色实例,绝不修改共享配置资产。
        nextAttackTime = Time.time + weapon.CooldownSeconds;
        if (animator != null && !string.IsNullOrEmpty(weapon.AttackTrigger))
            animator.SetTrigger(weapon.AttackTrigger);

        processedTargets.Clear();
        Vector3 center = transform.position + Vector3.up;
        Collider[] hits = Physics.OverlapSphere(
            center, weapon.AttackRange, targetLayers, QueryTriggerInteraction.Ignore);

        int hitCount = 0;
        foreach (Collider collider in hits)
        {
            HealthTarget target = collider.GetComponentInParent<HealthTarget>();
            if (target == null || target.transform.IsChildOf(transform) ||
                !processedTargets.Add(target)) continue;

            // 水平面内的点积 >= 0.5,相当于正前方左右各约 60°。
            Vector3 direction = target.transform.position - transform.position;
            direction.y = 0f;
            if (direction.sqrMagnitude < 0.0001f ||
                Vector3.Dot(transform.forward, direction.normalized) < 0.5f) continue;

            if (target.TakeDamage(weapon.Damage)) hitCount++;
        }

        Debug.Log($"攻击: {weapon.name}, 命中={hitCount}, 伤害={weapon.Damage}");
    }
}

预期结果:脚本编译后,WeaponAttack 可添加到角色对象,并在 Inspector 中指定 Weapon、可选的 Animator 和 Target Layers。Time.time 只用于该实例的冷却判断;Physics.OverlapSphere 搜索的是与球体接触的碰撞体,不是以目标中心点为准的精确距离判定。

创建受击目标并布置场景

为完成闭环,新建 Assets/Scripts/Combat/HealthTarget.cs。这个测试组件在 Awake 时把生命值设为 100;调用 TakeDamage 会扣除生命值,最低为 0,并打印实际结果。

csharp
using UnityEngine;

public sealed class HealthTarget : MonoBehaviour
{
    [SerializeField, Min(1)] private int maxHealth = 100;
    private int currentHealth;

    private void Awake()
    {
        currentHealth = maxHealth;
    }

    public bool TakeDamage(int damage)
    {
        if (currentHealth <= 0 || damage <= 0) return false;
        // 血量属于目标实例,不写回武器配置。
        currentHealth = Mathf.Max(0, currentHealth - damage);
        Debug.Log($"{name} HP={currentHealth}");
        return true;
    }
}

预期结果:给目标挂上该组件并在 Play 模式接收一次 12 点伤害后,Console 会出现 TrainingDummy HP=88;进入下一次 Play 时血量重新从 100 开始。

按以下步骤搭建最小测试场景:

  1. 创建空对象 Player,Position 设为 (0, 0, 0)、Rotation 设为 (0, 0, 0),挂上 WeaponAttack。其正前方是世界坐标 +Z。
  2. 创建空对象 TrainingDummy,Position 设为 (0, 0, 1.5),挂上 HealthTarget。添加一个 Capsule 子物体,将其 Local Position 设为 (0, 1, 0);保留 Capsule Collider,关闭 Is Trigger。
  3. 在 Layers > Add Layer... 中建立 Enemy 层,将 Capsule 子物体设为 Enemy,并在 Player 的 WeaponAttack > Target Layers 中仅选 Enemy。
  4. 把 TrainingSword 拖给 WeaponAttack > Weapon。先把 Animator 引用留空,这样未配置动画控制器也能测试伤害。
  5. 打开 Window > General > Console,进入 Play 模式,按下并松开空格以发起攻击。

验证两把武器能复用攻击逻辑

使用 TrainingSword 开始一次全新的 Play 会话,目标在前方 1.5 米时,第一次按空格的预期输出为:

text
TrainingDummy HP=88
攻击: TrainingSword, 命中=1, 伤害=12

退出 Play,把 WeaponAttack > Weapon 改为 HeavyHammer,重新进入 Play 再攻击一次。预期输出为:

text
TrainingDummy HP=68
攻击: HeavyHammer, 命中=1, 伤害=32

继续检查三个边界:轻剑两次按键间隔小于 0.35 秒时,第二次不产生攻击日志;重锤在 0.95 秒内也不能再次攻击。将 TrainingDummy 的 Z 改为 2.7,保留半径约 0.5 米的 Capsule Collider,轻剑通常无法命中而重锤可命中;最终判断由碰撞体形状和查询结果决定。把目标移至玩家身后,则两者都不应扣血。

需要接入动画时,在 Animator Controller 的 Parameters 中建立 LightAttack、HeavyAttack 两个 Trigger,并分别设置到轻击、重击状态的过渡条件,再把角色的 Animator 拖入组件。若 Console 提示参数不存在,先核对 Trigger 名称是否与资产字段完全一致。

换武器只替换 WeaponConfig 引用,无须复制攻击脚本。两名角色可以共用同一份武器资产,但它们的冷却时刻和目标生命值始终分别保存在各自的组件实例中。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 ScriptableObject 配置武器

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

登录哪都通