
Unity'de Envanter (Inventory) Sistemi Nasıl Yapılır?
Gerek RPG, gerek hayatta kalma (survival) gerekse basit bir bulmaca oyunu yapıyor olun; yolunuz eninde sonunda o malum sisteme düşecek: Inventory (Envanter) Sistemi!
Birçok geliştirici envanter sistemini yaparken devasa switch-case yapılarına veya karmaşık GameObject listelerine boğuluyor. Ama hiç gözünüz korkmasın. Bu yazıda Unity'nin sunduğu ScriptableObject mimarisini kullanarak temiz, performanslı ve genişletilebilir bir envanter sisteminin temellerini atacağız. Üstelik ilk versiyonlarda sık görülen yığın (stack) limiti hatalarını da baştan çözeceğiz.
Hazırsanız, kahvenizi alın ve başlayalım!
Mantık Nasıl İşleyecek? (Mimari)
Geliştireceğimiz sistemi 3 ana parçaya böleceğiz:
1. Item Data (ScriptableObject): Eşyalarımızın verilerini (isim, ikon, açıklama vb.) tutacak.
2. Inventory Logic (C# sınıfı): Envanterdeki eşyaları saklayacak, ekleme/çıkarma işlemlerini yapacak.
3. Inventory UI (Unity UI): Mantıksal envanteri ekranda oyuncuya gösterecek.
Bu ayrım (decoupling) sayesinde, ileride envanterin arayüzünü tamamen değiştirseniz bile oyun mantığınız bozulmaz.
Adım 1: Eşya Şablonunu Oluşturmak (ScriptableObject)
Öncelikle projede oluşturacağımız tüm eşyaların türeyeceği ItemSO script'ini yazalım.
using UnityEngine;
[CreateAssetMenu(fileName = "New Item", menuName = "Inventory/Item")]
public class ItemSO : ScriptableObject
{
public string id; // Kaydetme sistemi için benzersiz kimlik (örn: "potion_health")
public string itemName;
public Sprite icon;
[TextArea] public string description;
public bool isStackable; // Üst üste biner mi? (İksirler biner, kılıç binmez)
public int maxStackSize = 99;
}
Mert'in İpucu: [CreateAssetMenu] attribute'u sayesinde Project penceresine sağ tıklayıp Create > Inventory > Item diyerek saniyeler içinde yeni eşyalar (Kılıç, Can İksiri, Altın) üretebilirsiniz. id alanını şimdiden eklememizin sebebini yazının sonunda, kaydetme kısmında göreceksiniz.
Adım 2: Envanter Slotu Yapısı
Envanterde sadece eşyanın kendisi değil, o eşyadan kaç tane olduğu bilgisi de lazım. Bunun için basit bir C# sınıfı yazalım.
using System;
[Serializable]
public class InventorySlot
{
public ItemSO item;
public int count;
public InventorySlot(ItemSO item, int count)
{
this.item = item;
this.count = count;
}
public void AddCount(int value) => count += value;
public void RemoveCount(int value) => count -= value;
}
Adım 3: Envanter Yöneticisi (Inventory Manager)
Şimdi işin mutfağına geçelim. Eşya ekleme ve çıkarma mantığını burada yöneteceğiz. Arayüzün güncellenmesi için de C# event (Action) kullanacağız; böylece Manager, UI'ın varlığından bile haberdar olmak zorunda kalmaz.
Burada dikkat etmemiz gereken iki önemli nokta var:
• Yığın limiti: 95 iksiriniz varken 10 iksir daha eklerseniz, slot 105'e çıkmamalı. Önce mevcut slot 99'a doldurulmalı, kalan 6 iksir yeni bir slota geçmeli.
• Ya hep ya hiç: Envanterde yer yoksa eşyanın yarısını ekleyip yarısını yerde bırakmak hatalara açık kapı bırakır. Önce yer olup olmadığını kontrol edip sonra ekleyeceğiz.
using System;
using System.Collections.Generic;
using UnityEngine;
public class InventoryManager : MonoBehaviour
{
public static InventoryManager Instance { get; private set; }
public List<InventorySlot> inventory = new List<InventorySlot>();
public int maxSlots = 20;
// UI'ın dinleyeceği event
public event Action OnInventoryChanged;
private void Awake()
{
// Singleton yapısı
if (Instance == null) Instance = this;
else Destroy(gameObject);
}
public bool AddItem(ItemSO item, int amount = 1)
{
if (!HasSpaceFor(item, amount))
{
Debug.Log("Envanter dolu!");
return false;
}
int remaining = amount;
// 1. Stacklenebiliyorsa önce mevcut, dolmamış slotları doldur
if (item.isStackable)
{
foreach (InventorySlot slot in inventory)
{
if (slot.item != item || slot.count >= item.maxStackSize) continue;
int toAdd = Mathf.Min(item.maxStackSize - slot.count, remaining);
slot.AddCount(toAdd);
remaining -= toAdd;
if (remaining <= 0) break;
}
}
// 2. Kalan miktar için yeni slotlar aç
while (remaining > 0)
{
int toAdd = item.isStackable ? Mathf.Min(item.maxStackSize, remaining) : 1;
inventory.Add(new InventorySlot(item, toAdd));
remaining -= toAdd;
}
OnInventoryChanged?.Invoke(); // UI'ı bilgilendir
return true;
}
public bool RemoveItem(ItemSO item, int amount = 1)
{
if (GetItemCount(item) < amount) return false;
// Sondan başa doğru gezerek birden fazla slottan düşebiliriz
for (int i = inventory.Count - 1; i >= 0 && amount > 0; i--)
{
InventorySlot slot = inventory[i];
if (slot.item != item) continue;
int toRemove = Mathf.Min(slot.count, amount);
slot.RemoveCount(toRemove);
amount -= toRemove;
if (slot.count <= 0) inventory.RemoveAt(i);
}
OnInventoryChanged?.Invoke();
return true;
}
public int GetItemCount(ItemSO item)
{
int total = 0;
foreach (InventorySlot slot in inventory)
if (slot.item == item) total += slot.count;
return total;
}
private bool HasSpaceFor(ItemSO item, int amount)
{
int freeSlots = maxSlots - inventory.Count;
if (!item.isStackable) return freeSlots >= amount;
int space = freeSlots * item.maxStackSize;
foreach (InventorySlot slot in inventory)
if (slot.item == item) space += item.maxStackSize - slot.count;
return space >= amount;
}
}
Mert'in İpucu: GetItemCount küçük ama çok işe yarayan bir metot. "Kapıyı açmak için 3 anahtar gerekiyor" veya "Bu tarif için 5 odun lazım" gibi görev ve crafting kontrollerini tek satırda yapmanızı sağlar.
Adım 4: UI (Arayüz) Entegrasyonu
Görsel kısım için Unity Canvas üzerinde basit bir grid oluşturalım:
1. Bir Canvas oluşturun.
2. İçine bir Panel ekleyin ve adını InventoryGrid yapın.
3. Bu panele Grid Layout Group bileşeni ekleyin (böylece slotlar otomatik dizilir).
4. Bir Slot Prefab'ı hazırlayın: arka plan için bir Image, içinde eşya ikonu için ikinci bir Image ve miktar için bir TextMeshPro yazısı.
Önce slot prefab'ının üzerine eklenecek küçük bir script yazalım. Her slot kendi ikonunu ve miktarını göstermekten sorumlu olacak:
using TMPro;
using UnityEngine;
using UnityEngine.UI;
public class SlotUI : MonoBehaviour
{
[SerializeField] private Image iconImage;
[SerializeField] private TextMeshProUGUI countText;
public void Setup(InventorySlot slot)
{
iconImage.sprite = slot.item.icon;
iconImage.enabled = true;
countText.text = slot.count > 1 ? slot.count.ToString() : ""; // Tekil eşyada sayı gösterme
}
}
Şimdi tüm envanteri ekrana çizecek koda bakalım:
using UnityEngine;
public class InventoryUI : MonoBehaviour
{
[SerializeField] private Transform itemsParent; // Grid Layout Group'un olduğu obje
[SerializeField] private SlotUI slotPrefab;
private void Start()
{
// Manager'daki event'e abone oluyoruz
InventoryManager.Instance.OnInventoryChanged += UpdateUI;
UpdateUI();
}
private void OnDestroy()
{
// Event aboneliğini temizliyoruz (memory leak önlemek için)
if (InventoryManager.Instance != null)
InventoryManager.Instance.OnInventoryChanged -= UpdateUI;
}
private void UpdateUI()
{
// Önceki slot UI'larını temizle (basit yöntem)
foreach (Transform child in itemsParent)
Destroy(child.gameObject);
// Mevcut envanteri ekrana çiz
foreach (InventorySlot slot in InventoryManager.Instance.inventory)
{
SlotUI newSlot = Instantiate(slotPrefab, itemsParent);
newSlot.Setup(slot);
}
}
}
Neden Start içinde abone oluyoruz? InventoryManager.Instance değeri Awake içinde atanıyor. Unity tüm Awake çağrılarını Start'lardan önce yaptığı için Start içinde abone olmak güvenlidir. Awake veya OnEnable içinde abone olmaya çalışırsanız, script çalışma sırasına göre Instance henüz null olabilir.
Performans notu: Her değişiklikte tüm slotları silip yeniden oluşturmak 20 slotluk bir envanter için sorun değil. Ancak yüzlerce slotlu bir sandık veya sık güncellenen bir hızlı erişim çubuğu yapıyorsanız, slotları baştan bir kez oluşturup sadece içeriklerini güncellemek ya da Object Pooling kullanmak çok daha verimli olur.
Adım 5: Eşyayı Yerden Toplamak
Sistemi test etmenin en keyifli yolu, sahneye toplanabilir bir eşya koymak. Bir küpe Collider ekleyip Is Trigger kutusunu işaretleyin ve aşağıdaki script'i ekleyin. Oyuncu objenizin tag'inin Player olduğundan emin olun.
using UnityEngine;
public class ItemPickup : MonoBehaviour
{
[SerializeField] private ItemSO item;
[SerializeField] private int amount = 1;
private void OnTriggerEnter(Collider other)
{
if (!other.CompareTag("Player")) return;
// Sadece envantere başarıyla eklendiyse yerden kaldır
if (InventoryManager.Instance.AddItem(item, amount))
Destroy(gameObject);
}
}
AddItem metodunu "ya hep ya hiç" mantığıyla yazdığımız için burası tertemiz kaldı: envanter doluysa eşya yerde kalır, oyuncu yer açınca tekrar alabilir. Eşya ne kopyalanır ne de kaybolur.
Sık Yapılan Hata: Envanteri Kaydederken ScriptableObject Referansı
Envanteri JSON'a çevirip kaydetmek istediğinizde ilk karşılaşacağınız sürpriz şu olacak: JsonUtility, ItemSO gibi bir asset referansını dosyaya anlamlı şekilde yazamaz. Oyunu yeniden açtığınızda o referans boş gelir.
Çözüm, kayıt dosyasına eşyanın kendisini değil kimliğini yazmaktır. Adım 1'de eklediğimiz id alanı tam olarak bunun için:
[System.Serializable]
public class SlotSaveData
{
public string itemId; // ItemSO yerine sadece id'sini saklıyoruz
public int count;
}
Yüklerken de projedeki tüm eşyaları tutan bir ItemDatabase (yine bir ScriptableObject listesi olabilir) üzerinden id'ye karşılık gelen ItemSO'yu bulup slotu yeniden kurarsınız. Kayıt dosyasını da PlayerPrefs yerine Application.persistentDataPath altına yazmanızı öneririm.
Gelecek Adımlarda Neler Yapılabilir? (Pro Önerileri)
Sistemimizin temeli hazır! Peki bunu bir tık öteye nasıl taşıyabiliriz?
• Drag & Drop (Sürükle-Bırak): Unity'nin IBeginDragHandler, IDragHandler ve IEndDragHandler interface'lerini kullanarak eşyaların yerini değiştirebilirsiniz.
• Save / Load: Yukarıdaki id yaklaşımıyla envanteri JSON olarak kaydedip yükleyebilirsiniz.
• Equipment System: Eşyaya bir ItemType enum'u (Armor, Weapon, Consumable) ekleyerek oyuncunun kuşanabileceği bir ekipman sistemiyle birleştirebilirsiniz.
• Kullanılabilir Eşyalar: ItemSO içine sanal bir Use() metodu ekleyip HealthPotionSO gibi alt sınıflarla her eşyaya kendi davranışını verebilirsiniz.
Özet
Gördüğünüz gibi, doğru mimariyle (ScriptableObject + event tabanlı yapı) esnek bir envanter sistemi kurmak hiç de zor değil. Yığın limitlerini doğru yöneten, dolu envanterde eşya kaybetmeyen ve UI'dan tamamen bağımsız bir yapımız var. Yeni bir eşya eklemek istediğinizde tek satır kod yazmadan, sadece editörden yeni bir ScriptableObject oluşturmanız yeterli!
Siz envanter sistemlerinizde hangi yöntemleri kullanıyorsunuz? Sürükle-bırak sistemi için ayrı bir yazı gelsin ister misiniz? Yorumlarda benimle paylaşmayı unutmayın!
Bir sonraki Unity rehberinde görüşmek üzere, kodla kalın, oyunla kalın!
— Mert Kıyak
