Envanter Sistemi Mantığı ve Eşya Yönetimi Nasıl Yapılır?

Oyun geliştirmede envanter sistemi mantığı ve eşya yönetimi, oyuncunun dünyada karşılaştığı, topladığı, kullandığı ya da depoladığı tüm nesnelerin arka planda düzenli bir veri yapısıyla işlenmesi ve kullanıcı arayüzüne (UI) aktarılması sürecidir. Oyun mimarisinde envanter tasarımı, yalnızca kullanıcı deneyimini doğrudan şekillendirmekle kalmaz; aynı zamanda veritabanı ile arayüz arasındaki veri trafiğini yöneten en kritik temel mekanizmalardan biridir.
- Envanter sisteminin arka plandaki veri mimarisini ve mantığını kavramak
- Eşya (Item) verisini ScriptableObject veya veri sınıfları ile modellemek
- Slot tabanlı, ağırlık tabanlı ve grid envanter sistemlerinin farklarını öğrenmek
- Veri katmanı ile arayüz (UI) arasındaki haberleşmeyi olay güdümlü (Event-Driven) mimari ile kurmak
- Envanter verilerini JSON formatında kaydetme ve yükleme mantığını anlamak
- Eşya verisi (Data) ile eşyanın ekrandaki görüntüsü (UI) tamamen birbirinden ayrı tutulmalıdır (MVC veya Observer prensipleri).
- Dinamik envanter alanları için Liste (List), hızlı erişim ve indeksleme için Sözlük (Dictionary) veri yapıları tercih edilir.
- Olay temelli programlama (Events/Delegates) sayesinde envanter değiştiğinde UI gereksiz yere her karede (Update) güncellenmez.
- İstiflenebilir (Stackable) eşyalarda miktar kontrolü ve maksimum sınır algoritmaları kullanılır.
Oyunlarda Envanter Sistemi Nedir ve Neden Gereklidir?
Oyun geliştirme dünyasında envanter sistemi; oyuncunun topladığı materyalleri, silahları, iksirleri ve giysileri düzenli biçimde saklamasına olanak tanıyan veri ve arayüz bütünüdür. İster bir rol yapma oyunu (RPG) ister bir hayatta kalma (Survival) yapımı olsun, envanter mantığı oyun ekonomisinin ve ilerleyişin temel taşını oluşturur.
Bir oyuncu yerdeki iksiri topladığında, oyun motoru arka planda bu fiziksel nesneyi sahneden kaldırarak belleğe iksire ait bilgileri içeren yeni bir veri girdisi ekler. Dolayısıyla iyi kurgulanmış bir envanter sistemi, ekranda beliren kutucuklardan çok daha fazlasını ifade eder. Sistemin mimarisi, performans optimizasyonu ve veri güvenliği göz önüne alınarak titizlikle kodlanmalıdır. Bu noktada Ağ Programlama ve Çok Oyunculu Mod Mantığı Nedir? başlıklı anlatım da işinizi kolaylaştırabilir.
Envanter Sisteminin Temel Veri Yapısı ve Mantığı
Envanter sisteminin kalbinde Nesne Yönelimli Programlama (OOP) prensipleri yer alır. Oyundaki her bir eşya, kendine has özelliklere sahip bağımsız bir nesne olarak tanımlanmalıdır. Bir eşya sınıfı (Item Class) oluşturulduğunda bu yapının içermesi gereken temel değişkenler şunlardır:
- itemID (String / Int): Eşyanın benzersiz kimlik numarası.
- itemName (String): Oyuncunun ekranda göreceği ad.
- itemType (Enum): Eşyanın türü (Silah, Zırh, Tüketilebilir, Materyal).
- icon (Sprite / Texture): Arayüzde görüntülenecek ikon.
- maxStackSize (Int): Bir slotta kaç adet üst üste binebileceği.
- isStackable (Bool): İstiflenebilir olup olmadığı bilgisi.
Eşya tanımı yapıldıktan sonra envanterin kendisi bir veri kapsayıcısı (Container) olarak görev yapar. Geliştiriciler genellikle dinamik diziler (List<ItemSlot>) veya anahtar-değer çiftleri (Dictionary<Item, int>) aracılığıyla hafızadaki eşya listesini yönetirler. Örneğin Unity platformunda ScriptableObject mimarisi, eşya verilerini şablonlar halinde saklamak adına son derece verimli bir çözümdür.
Eşya Yönetiminde Kullanılan Temel Yöntemler ve Mimari
Oyun türüne bağlı olarak tercih edilen farklı envanter tipleri bulunmaktadır. Tasarlayacağınız oyunun dinamiği, seçeceğiniz eşya yönetim mimarisini doğrudan etkiler.
| Envanter Tipi | Kullanım Alanı | Avantajları | Zorluk Derecesi |
|---|---|---|---|
| Slot Tabanlı (Grid-Free) | Minecraft, Terraria | Kullanımı ve kodlaması kolay, hücre sınırlı | Düşük |
| Grid/Tetris Tabanlı | Diablo, Escape from Tarkov | Stratejik alan yönetimi sunar, görsel olarak zengindir | Yüksek |
| Ağırlık Tabanlı (Weight) | Skyrim, Fallout | Sınırsız çeşitlilik, gerçekçi taşıma kapasitesi | Orta |
| Kategori/Liste Tabanlı | JRPG Oyunları, Witcher | Sonsuz ölçeklenebilirlik, temiz arayüz | Düşük – Orta |
Hangi yöntemi seçerseniz seçin, mantık her zaman veri ile arayüzün ayrıştırılması (Decoupling) esasına dayanmalıdır. Oyuncu bir eşyayı sürükleyip bıraktığında (Drag and Drop), güncellenen şey aslında ekrandaki görsel ikon değil, arka planda o nesneye karşılık gelen veri indeksidir.
Envanter Sistemi Oluşturma Adımları (Adım Adım Rehber)
Başarılı ve modüler bir eşya yönetim sistemi kurmak için izlemeniz gereken 4 temel adım bulunmaktadır:
1. Eşya Veri Yapısının Oluşturulması
İlk aşamada oyun içerisindeki tüm nesnelerin temelini oluşturacak bir `Item` veri sınıfı tanımlanır. Bu sınıf yalnızca verileri bünyesinde barındırır; herhangi bir iş mantığı çalıştırmaz.
2. Envanter Yöneticisi (Inventory Manager) Kodlaması
Envanterin beyni olan bu bileşen tekil (Singleton) mimaride tasarlanabilir. Eşya ekleme (`AddItem`), eşya çıkarma (`RemoveItem`) veya envanterde yer kontrolü (`HasSpace`) gibi temel metotlar bu katmanda kurgulanır.
3. Olay Güdümlü (Event-Driven) Arayüz Bağlantısı
Envanter verisinde herhangi bir değişiklik meydana geldiğinde (örneğin çantaya yeni bir iksir eklendiğinde), Envanter Yöneticisi bir olay (Event/Delegate) tetikler. Arayüz sınıfı ise bu olayı dinleyerek yalnızca veri değiştiğinde ekrandaki slotları günceller. Bu yaklaşımı farklı bir örnekte görmek isteyenler Bağımsız Oyun Geliştiriciliği ve Proje Yönetimi Nedir? sayfasına bakabilir.
4. Dünya İle Etkileşim (Pick-up & Drop)
Sahnede duran fiziksel nesneye bir `ItemPickUp` bileşeni eklenir. Oyuncu bu nesneye temas ettiğinde veya etkileşim tuşuna bastığında, nesne `InventoryManager.Instance.AddItem()` fonksiyonuna kendi veri şablonunu gönderir ve ardından sahneden silinir (`Destroy`). Aynı mantığın nasıl işlediğini Kamera Sistemleri ve Üçüncü Şahıs Bakış Açısı Nasıl Yapılır? üzerinden de görebilirsiniz.
Grid Tabanlı ve İstiflenebilir (Stackable) Envanter Mantığı
Eşya yönetiminin en kritik alanlarından biri istifleme (Stacking) algoritmalarıdır. Oyuncu çantasına yeni bir eşya eklediğinde sistem şu mantık sırasını izlemelidir:
- İstiflenebilirlik Kontrolü: Eşya istiflenebilir mi? (`isStackable == true`)
- Mevcut Slot Arama: Envanterde aynı eşyadan ve henüz maksimum kapasitesine ulaşmamış bir slot var mı?
- Miktar Ekleme: Varsa, yeni miktar mevcut slotun kapasitesini aşıyor mu? Aşmıyorsa ekle, aşıyorsa kalanı yeni bir boş slota aktar.
- Boş Slot Bulma: Eğer mevcut istiflenecek slot yoksa ilk boş slotu (`null` olan slot) bul ve eşyayı oraya yerleştir.
- Envanter Dolu Uyarısı: Boş slot da yoksa eşyayı sahneye geri düşür veya oyuncuya “Envanter Dolu” uyarısı vererek işlemi iptal et.
Bu mantık dizilimi, veri yapısındaki (List/Array) değişikliklerin kullanıcı arayüzüne (UI) hatasız ve anlık olarak yansıtılmasını sağlar.
Envanter Yönetiminde En İyi Uygulamalar
Başarılı bir eşya yönetim sistemi kurmak için veri ile görsel katmanı (UI) birbirinden ayırmak kritik önem taşır. Eşya verilerini ScriptableObject veya JSON gibi yapılarda tutarak modülerliği sağlayabilir, sürükle-bırak (Drag & Drop) etkileşimlerini olay odaklı (Event-Driven) bir mimariyle yöneterek performans kayıplarının önüne geçebilirsiniz.
Sıkça Sorulan Sorular
- Game Programming Patterns (Robert Nystrom) — Veri odaklı tasarım, Flyweight kalıbı ve oyun içi durum yönetimi
- Unity Documentation – Event System & UI — Kullanıcı arayüzü etkileşimleri ve sürükle-bırak olay yönetimi


