游戏引擎 / 系统课时
用配置资产管理可拾取物品
用配置资产管理可拾取物品
同一种药水可以在关卡的多个位置出现,但名称、图标和堆叠规则不应重复填写。本课创建可复用的 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 修改,公开属性只提供读取。
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 返回实际接收数,以便满格时让未拾取的物品留在场景中。
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 上。触发拾取时,先询问背包接收了多少,再扣除场景剩余数;只有全部接收才销毁场景物体。
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 的两件拾取物):
拾取 小型治疗药水 x3;当前总数 3;占用格数 1
拾取 小型治疗药水 x19;当前总数 22;占用格数 2在 Unity 6 中挂载并验收
- 等待三个脚本编译完成,将
PlayerInventory添加到玩家根对象,设置Slot Capacity=8。玩家必须带有CharacterController或适合触发器检测的 Collider,且进入触发区的 Collider 所属对象或父对象上能找到PlayerInventory。 - 选择
GameObject > 3D Object > Sphere创建Pickup_A,添加WorldItemPickup。该脚本会要求同一对象具备SphereCollider和Rigidbody;确认Is Trigger已勾选、Is Kinematic已勾选、Use Gravity已取消。 - 将
Potion_Small拖入Definition,填写Quantity=3。复制为Pickup_B,改成Quantity=19,与 A 相隔约 3 米,确保玩家依次触发两处。 - 进入 Play 模式并依次触碰 A、B,Console 应出现上述两行。两个拾取物消失;再次查看
Potion_Small,Max Stack仍为 20。
再把玩家的 Slot Capacity 改为 1,重新进入 Play 模式。先拿 3 件,再拿 19 件,第二次只能接收 17 件;B 不会被销毁,Inspector 中其 Quantity 应剩下 2。这时玩家离开再进入触发区也不会继续拾取,除非腾出背包空间。
同一种物品的多个拾取物应引用同一个配置资产,不要复制出多个 ID 相同的资产。也不要把 currentQuantity 写进 ItemDefinition:共享资产负责描述物品,世界数量归拾取组件,玩家持有量归背包;这三类数据在编辑、运行和存档时有不同的生命周期。