游戏引擎 / 系统课时

用配置资产管理可拾取物品

用配置资产管理可拾取物品

同一种药水可以在关卡的多个位置出现,但名称、图标和堆叠规则不应重复填写。本课创建可复用的 ItemDefinition 配置资产,让场景拾取物只保存资产引用和待拾取数量,背包独立记录持有数量,并在 Unity 6 中验证拾取与堆叠。

学习目标

  • 使用 ScriptableObject 保存物品 ID、显示名称、图标、类型和最大堆叠数。
  • 让多个场景拾取物引用同一个定义,同时保留各自的数量。
  • 实现按堆叠上限接收物品的最小背包,并验证部分拾取与满格行为。

区分物品定义、场景实例和背包数据

假设“小型治疗药水”的单格堆叠上限是 20,关卡中分别放置 3 件和 19 件。两处场景物体共享同一个物品定义,但各自的 quantity 不同;玩家全部拾取后,背包应有两格,数量分别是 20 和 2。

数据所在位置 负责保存 示例
ItemDefinition 资产 不随拾取改变的共享配置 itemId=potion.small、maxStack=20
WorldItemPickup 组件 当前场景物体剩余的待拾取数量 quantity=3 或 19
PlayerInventory 组件 玩家运行时持有的物品及每格数量 第一格 20,第二格 2

物品定义资产、场景拾取物与背包堆叠的数据流

创建 ItemDefinition 配置资产

在 Assets/Scripts/Items 新建 ItemDefinition.cs。CreateAssetMenu 让设计人员能直接在 Project 窗口创建配置;私有序列化字段可以在 Inspector 修改,公开属性只提供读取。

csharp
using UnityEngine;

public enum ItemType { Consumable, Material, Quest }

[CreateAssetMenu(fileName = "Item_New", menuName = "Game/Items/Item Definition")]
public sealed class ItemDefinition : ScriptableObject
{
    [SerializeField] private string itemId = "item.new";
    [SerializeField] private string displayName = "新物品";
    [SerializeField] private Sprite icon;
    [SerializeField] private ItemType type = ItemType.Material;
    [SerializeField, Min(1)] private int maxStack = 1;

    // 运行时系统只读取资产,不向资产写入持有数量。
    public string ItemId => itemId;
    public string DisplayName => displayName;
    public Sprite Icon => icon;
    public ItemType Type => type;
    public int MaxStack => Mathf.Max(1, maxStack);

    private void OnValidate()
    {
        // 防止旧数据或 Inspector 误填出零堆叠上限。
        maxStack = Mathf.Max(1, maxStack);
    }
}

在 Project 窗口建立 Assets/Items 文件夹,右键选择 Create > Game > Items > Item Definition,将新资产命名为 Potion_Small。Inspector 中填写 Item Id=potion.small、Display Name=小型治疗药水、Type=Consumable、Max Stack=20。图标纹理在导入设置中选 Texture Type=Sprite (2D and UI),再拖到 Icon 字段。

itemId 应在全项目保持唯一且发布后尽量不改:存档和任务系统以后可以用它识别物品。文件名 Potion_Small 便于美术管理,但不宜当作存档标识。

用背包组件保存运行时堆叠

下面的 PlayerInventory 是可直接挂到玩家上的最小版本,默认提供 8 个槽位。先填满同一资产的已有堆叠,再申请新槽位;Add 返回实际接收数,以便满格时让未拾取的物品留在场景中。

csharp
using System.Collections.Generic;
using UnityEngine;

public sealed class PlayerInventory : MonoBehaviour
{
    private sealed class ItemStack
    {
        public ItemDefinition Definition;
        public int Quantity;
    }

    [SerializeField, Min(1)] private int slotCapacity = 8;
    private readonly List<ItemStack> stacks = new List<ItemStack>();

    public int Add(ItemDefinition definition, int amount)
    {
        if (definition == null || string.IsNullOrWhiteSpace(definition.ItemId) || amount <= 0)
            return 0;

        int remaining = amount;
        foreach (ItemStack stack in stacks)
        {
            if (stack.Definition != definition) continue;
            int moved = Mathf.Min(remaining, definition.MaxStack - stack.Quantity);
            if (moved <= 0) continue;
            stack.Quantity += moved;
            remaining -= moved;
            if (remaining == 0) break;
        }

        // 已有堆叠满了才占用新槽位,每格不超过 MaxStack。
        while (remaining > 0 && stacks.Count < slotCapacity)
        {
            int moved = Mathf.Min(remaining, definition.MaxStack);
            stacks.Add(new ItemStack { Definition = definition, Quantity = moved });
            remaining -= moved;
        }

        int accepted = amount - remaining;
        if (accepted > 0)
        {
            int total = 0;
            foreach (ItemStack stack in stacks)
                if (stack.Definition == definition) total += stack.Quantity;
            Debug.Log($"拾取 {definition.DisplayName} x{accepted};当前总数 {total};占用格数 {stacks.Count}");
        }
        return accepted;
    }
}

这里的列表没有写回 ScriptableObject,退出 Play 模式即重置。示例以资产引用判断同种物品;实际存档则应保存稳定 itemId 和每格数量,并在读档时用物品目录把 ID 找回对应定义。

让场景拾取物引用同一资产

创建 WorldItemPickup.cs,把定义引用和该物体当前数量放在 MonoBehaviour 上。触发拾取时,先询问背包接收了多少,再扣除场景剩余数;只有全部接收才销毁场景物体。

csharp
using UnityEngine;

[RequireComponent(typeof(SphereCollider), typeof(Rigidbody))]
public sealed class WorldItemPickup : MonoBehaviour
{
    [SerializeField] private ItemDefinition definition;
    [SerializeField, Min(1)] private int quantity = 1;
    private bool collected;

    private void Reset()
    {
        // 拾取区只检测进入,不参与物理推动。
        GetComponent<SphereCollider>().isTrigger = true;
        Rigidbody body = GetComponent<Rigidbody>();
        body.isKinematic = true;
        body.useGravity = false;
    }

    private void OnTriggerEnter(Collider other)
    {
        if (collected || definition == null) return;
        PlayerInventory inventory = other.GetComponentInParent<PlayerInventory>();
        if (inventory == null) return;

        // 背包空间不足时,未接收的数量保留在世界物体上。
        int accepted = inventory.Add(definition, quantity);
        quantity -= accepted;
        if (quantity <= 0)
        {
            collected = true;
            Destroy(gameObject);
        }
    }
}

预期输出(下一节按顺序接触数量为 3 和 19 的两件拾取物):

text
拾取 小型治疗药水 x3;当前总数 3;占用格数 1
拾取 小型治疗药水 x19;当前总数 22;占用格数 2

在 Unity 6 中挂载并验收

  1. 等待三个脚本编译完成,将 PlayerInventory 添加到玩家根对象,设置 Slot Capacity=8。玩家必须带有 CharacterController 或适合触发器检测的 Collider,且进入触发区的 Collider 所属对象或父对象上能找到 PlayerInventory。
  2. 选择 GameObject > 3D Object > Sphere 创建 Pickup_A,添加 WorldItemPickup。该脚本会要求同一对象具备 SphereCollider 和 Rigidbody;确认 Is Trigger 已勾选、Is Kinematic 已勾选、Use Gravity 已取消。
  3. 将 Potion_Small 拖入 Definition,填写 Quantity=3。复制为 Pickup_B,改成 Quantity=19,与 A 相隔约 3 米,确保玩家依次触发两处。
  4. 进入 Play 模式并依次触碰 A、B,Console 应出现上述两行。两个拾取物消失;再次查看 Potion_Small,Max Stack 仍为 20。

再把玩家的 Slot Capacity 改为 1,重新进入 Play 模式。先拿 3 件,再拿 19 件,第二次只能接收 17 件;B 不会被销毁,Inspector 中其 Quantity 应剩下 2。这时玩家离开再进入触发区也不会继续拾取,除非腾出背包空间。

同一种物品的多个拾取物应引用同一个配置资产,不要复制出多个 ID 相同的资产。也不要把 currentQuantity 写进 ItemDefinition:共享资产负责描述物品,世界数量归拾取组件,玩家持有量归背包;这三类数据在编辑、运行和存档时有不同的生命周期。

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

目录与阅读设置

阅读设置

17

记录一个想法

用配置资产管理可拾取物品

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

登录哪都通