游戏引擎 / 系统课时
用 ScriptableObject 配置武器
用 ScriptableObject 配置武器
为木剑和重锤分别编写攻击脚本,会让伤害、距离与冷却逻辑不断重复。本课把四项武器参数放进 ScriptableObject 资产,由同一个近战组件读取。完成后只需切换资产引用,就能验证两种武器的差异,同时保证每个角色的冷却计时独立。
学习目标
- 建立可复用的
WeaponConfig资产,配置伤害、攻击范围、冷却和动画触发名。 - 让同一个
WeaponAttack组件读取不同武器配置,不把运行时状态写入资产。 - 在 Unity 6 场景中测试两种武器的命中伤害、距离和冷却。
定义武器配置资产
在 Assets/Scripts/Combat/WeaponConfig.cs 新建脚本。ScriptableObject 不挂在 GameObject 上;通过 CreateAssetMenu,可直接在 Project 窗口创建 .asset 文件。[SerializeField] 让私有字段可在 Inspector 编辑,只读属性供战斗代码读取。
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,按提示重启编辑器。
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,并打印实际结果。
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 开始。
按以下步骤搭建最小测试场景:
- 创建空对象
Player,Position 设为(0, 0, 0)、Rotation 设为(0, 0, 0),挂上WeaponAttack。其正前方是世界坐标+Z。 - 创建空对象
TrainingDummy,Position 设为(0, 0, 1.5),挂上HealthTarget。添加一个 Capsule 子物体,将其 Local Position 设为(0, 1, 0);保留 Capsule Collider,关闭Is Trigger。 - 在
Layers > Add Layer...中建立Enemy层,将 Capsule 子物体设为Enemy,并在Player的WeaponAttack > Target Layers中仅选Enemy。 - 把
TrainingSword拖给WeaponAttack > Weapon。先把Animator引用留空,这样未配置动画控制器也能测试伤害。 - 打开
Window > General > Console,进入 Play 模式,按下并松开空格以发起攻击。
验证两把武器能复用攻击逻辑
使用 TrainingSword 开始一次全新的 Play 会话,目标在前方 1.5 米时,第一次按空格的预期输出为:
TrainingDummy HP=88
攻击: TrainingSword, 命中=1, 伤害=12退出 Play,把 WeaponAttack > Weapon 改为 HeavyHammer,重新进入 Play 再攻击一次。预期输出为:
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 引用,无须复制攻击脚本。两名角色可以共用同一份武器资产,但它们的冷却时刻和目标生命值始终分别保存在各自的组件实例中。