47 lines
1.6 KiB
C#
47 lines
1.6 KiB
C#
using System.Collections.Generic;
|
||
using UnityEngine;
|
||
|
||
namespace BaseGames.Inventory
|
||
{
|
||
/// <summary>
|
||
/// 道具目录 SO（背包系统）。
|
||
/// 全局唯一资产（建议 Assets/_Game/Data/Inventory/ItemDatabase.asset），
|
||
/// 通过 itemId 查找 <see cref="ItemSO"/> 引用。
|
||
/// 由 <see cref="InventoryManager"/> 在拾取 / OnLoad 时查询。
|
||
/// 设计对照 <see cref="BaseGames.Equipment.CharmCatalogSO"/>，但内部用字典缓存以支持高频查询。
|
||
/// </summary>
|
||
[CreateAssetMenu(menuName = "BaseGames/Inventory/ItemDatabase")]
|
||
public class ItemDatabaseSO : ScriptableObject
|
||
{
|
||
[SerializeField] private ItemSO[] _items;
|
||
|
||
public IReadOnlyList<ItemSO> AllItems => _items;
|
||
|
||
private Dictionary<string, ItemSO> _index;
|
||
|
||
/// <summary>按 itemId 查找道具，找不到返回 null。</summary>
|
||
public ItemSO Find(string itemId)
|
||
{
|
||
if (string.IsNullOrEmpty(itemId) || _items == null) return null;
|
||
EnsureIndex();
|
||
return _index.TryGetValue(itemId, out var item) ? item : null;
|
||
}
|
||
|
||
private void EnsureIndex()
|
||
{
|
||
if (_index != null) return;
|
||
_index = new Dictionary<string, ItemSO>(_items.Length);
|
||
foreach (var item in _items)
|
||
if (item != null && !string.IsNullOrEmpty(item.itemId))
|
||
_index[item.itemId] = item;
|
||
}
|
||
|
||
/// <summary>编辑器修改 _items 后清空索引，下次 Find 重建。</summary>
|
||
public void InvalidateIndex() => _index = null;
|
||
|
||
#if UNITY_EDITOR
|
||
private void OnValidate() => _index = null;
|
||
#endif
|
||
}
|
||
}
|