【Unity入門】アイテム所持の仕組みを作ろう ― 「データ」と「見た目」を分ける考え方

using System;
using System.Collections.Generic;
using System.Linq;
using UnityEngine;

[Serializable]
public class OwnedItemsData
{
    // PlayerPrefsの保存先キー
    private const string PlayerPrefsKey = "OWNED_ITEMS_DATA";

    private static OwnedItemsData _instance;

    // どのアイテムを何個所持しているかのリスト
    [SerializeField] private List<OwnedItem> ownedItems = new List<OwnedItem>();

    // 外部からnewできないようにする
    private OwnedItemsData()
    {
    }

    // インスタンスを返す(初回だけ作る)
    public static OwnedItemsData Instance
    {
        get
        {
            if (_instance == null)
            {
                _instance = LoadOrCreate();
            }

            return _instance;
        }
    }

    // 所持アイテム一覧を取得する
    public OwnedItem[] OwnedItems
    {
        get
        {
            return ownedItems.ToArray();
        }
    }

    // JSON化してPlayerPrefsに保存する
    public void Save()
    {
        var jsonString = JsonUtility.ToJson(this);
        PlayerPrefs.SetString(PlayerPrefsKey, jsonString);
        PlayerPrefs.Save();
    }

    // アイテムを追加する
    public void Add(Item.ItemType type, int amount = 1)
    {
        var item = GetItem(type);
        if (item == null)
        {
            item = new OwnedItem(type);
            ownedItems.Add(item);
        }

        item.Add(amount);
    }

    // アイテムを消費する
    public void Use(Item.ItemType type, int amount = 1)
    {
        var item = GetItem(type);
        if (item == null || item.Number < amount)
        {
            throw new InvalidOperationException("アイテムが足りません");
        }

        item.Use(amount);
    }

    // 対象の種類のアイテムデータを取得する(持っていなければnull)
    public OwnedItem GetItem(Item.ItemType type)
    {
        return ownedItems.FirstOrDefault(x => x.Type == type);
    }

    // 保存データがあれば復元し、なければ新しく作る
    private static OwnedItemsData LoadOrCreate()
    {
        if (!PlayerPrefs.HasKey(PlayerPrefsKey))
        {
            return new OwnedItemsData();
        }

        var jsonString = PlayerPrefs.GetString(PlayerPrefsKey);
        return JsonUtility.FromJson<OwnedItemsData>(jsonString);
    }

    // アイテム1種類ぶんの「種類と個数」
    [Serializable]
    public class OwnedItem
    {
        [SerializeField] private Item.ItemType type;
        [SerializeField] private int number;

        public OwnedItem(Item.ItemType type)
        {
            this.type = type;
        }

        public Item.ItemType Type
        {
            get
            {
                return type;
            }
        }

        public int Number
        {
            get
            {
                return number;
            }
        }

        public void Add(int amount)
        {
            number += amount;
        }

        public void Use(int amount)
        {
            number -= amount;
        }
    }
}

• Add:もう持っていれば個数を足し、なければ行を作る
• Instance:初回だけ LoadOrCreate で作る(遅延初期化)
• Save:メモ帳をJSONにして PlayerPrefs へ保存する

using DG.Tweening;
using UnityEngine;

[RequireComponent(typeof(Collider))]
public class Item : MonoBehaviour
{
    // アイテムの種類定義
    public enum ItemType
    {
        Wood,
        Stone,
        ThrowAxe
    }

    // 出現アニメーションの長さ(秒)
    private const float AnimationSeconds = 0.5f;

    // 落ちる位置のばらつき(±この距離)
    private const float DropRange = 1f;

    [SerializeField] private ItemType type;

    // 出現時の初期化(ぽんと弾むアニメーション)
    public void Initialize()
    {
        // アニメーションが終わるまでcolliderを無効化する
        var itemCollider = GetComponent<Collider>();
        itemCollider.enabled = false;

        // 落とす位置を、周囲にランダムに決める
        var dropPosition = transform.localPosition
            + new Vector3(Random.Range(-DropRange, DropRange), 0, Random.Range(-DropRange, DropRange));

        // 大きさをゼロにしてから、元の大きさに戻す
        var defaultScale = transform.localScale;
        transform.localScale = Vector3.zero;

        transform.DOLocalMove(dropPosition, AnimationSeconds);
        transform.DOScale(defaultScale, AnimationSeconds)
            .SetEase(Ease.OutBounce)
            .OnComplete(() => itemCollider.enabled = true);
    }

    // プレイヤーが触れたら拾う
    private void OnTriggerEnter(Collider other)
    {
        if (!other.CompareTag("Player"))
        {
            return;
        }

        // 所持品としてメモ帳に追加して、保存する
        OwnedItemsData.Instance.Add(type);
        OwnedItemsData.Instance.Save();

        // 地面のアイテムは消す
        Destroy(gameObject);
    }
}

• Initialize:出現アニメーション中は当たり判定を切る
• OnTriggerEnter:触れたらメモ帳に足して保存し、自分は消える
• Collider の Is Trigger をオンにし、プレイヤーには Player タグを付けておく

using UnityEngine;

public class ItemsDialog : MonoBehaviour
{
    [SerializeField] private int buttonNumber = 15;
    [SerializeField] private ItemButton itemButton;

    private ItemButton[] _itemButtons;

    // アイテム欄の表示/非表示を切り替える
    public void Toggle()
    {
        gameObject.SetActive(!gameObject.activeSelf);

        if (gameObject.activeSelf)
        {
            RefreshButtons();
        }
    }

    private void Start()
    {
        // 初期状態は非表示
        gameObject.SetActive(false);
        CreateButtons();
    }

    // アイテム欄(マス)を必要な数だけそろえる
    private void CreateButtons()
    {
        // 元のボタンが1個あるので、残りを複製する
        for (int i = 0; i < buttonNumber - 1; i++)
        {
            Instantiate(itemButton, transform);
        }

        // 子要素のアイテムボタンを一括取得して保持する
        _itemButtons = GetComponentsInChildren<ItemButton>();
    }

    // 全マスを、メモ帳の内容で更新する
    private void RefreshButtons()
    {
        var ownedItems = OwnedItemsData.Instance.OwnedItems;

        for (int i = 0; i < buttonNumber; i++)
        {
            // 持ち物の数より後ろのマスは、空(null)にする
            _itemButtons[i].OwnedItem = i < ownedItems.Length ? ownedItems[i] : null;
        }
    }
}

• Start:CreateButtons でマスを15個そろえる
• Toggle:開くたびに RefreshButtons で、メモ帳を上から順に各マスへ割り当てる
• 最大15種類まで表示する簡易仕様。超えた分は表示されない

using System;
using System.Linq;
using UnityEngine;
using UnityEngine.UI;

[RequireComponent(typeof(Button))]
public class ItemButton : MonoBehaviour
{
    // 各アイテム用の画像を指定するフィールド
    [SerializeField] private ItemTypeSpriteMap[] itemSprites;
    [SerializeField] private Image image;
    [SerializeField] private Text number;

    private Button _button;
    private OwnedItemsData.OwnedItem _ownedItem;

    // このマスに割り当てる持ち物(空のマスはnull)
    public OwnedItemsData.OwnedItem OwnedItem
    {
        get
        {
            return _ownedItem;
        }
        set
        {
            _ownedItem = value;
            Refresh();
        }
    }

    private void Awake()
    {
        _button = GetComponent<Button>();
        _button.onClick.AddListener(OnClick);
    }

    private void OnClick()
    {
        // ボタンを押したときの処理(今回は未実装)
    }

    // データの有無で、画像・個数・ボタンの表示を切り替える
    private void Refresh()
    {
        var isEmpty = _ownedItem == null;

        image.gameObject.SetActive(!isEmpty);
        number.gameObject.SetActive(!isEmpty);
        _button.interactable = !isEmpty;

        if (isEmpty)
        {
            return;
        }

        image.sprite = itemSprites.First(x => x.itemType == _ownedItem.Type).sprite;
        number.text = _ownedItem.Number.ToString();
    }

    [Serializable]
    public class ItemTypeSpriteMap
    {
        public Item.ItemType itemType;
        public Sprite sprite;
    }
}

• OwnedItem に代入されると Refresh が呼ばれ、表示が切り替わる
• データが null なら、画像・個数・ボタンを隠す
• OnClick は空(アイテムを使う処理は、次回の実装)