Minecraft Sunucusuna Shop Eklentisi Kurma

Minecraft sunucusuna shop eklentisi kurmak, oyuncuların eşya alıp satabildiği bir mağaza sistemi kurmak demektir ve 2026 itibarıyla 26.2 “Chaos Cubed” sunucularında bunun kararlı tek yolu QuickShop-Hikari 6.3.0.1 kurmaktan geçer. Kurulum üç parçadan oluşur: ekonomi köprüsü (VaultUnlocked), paranın kendisini tutan ekonomi eklentisi ve mağaza eklentisinin kendisi. Bu üçü eksiksiz olmadan hiçbir mağaza açılmaz.

Mağaza sistemi, bir sunucunun en çok oynanan bölümüdür. Oyuncular kazandıkları parayı harcayacak bir yer bulamazsa ekonomi anlamsızlaşır, sunucuda kalma süresi düşer. Bu yüzden shop eklentisi genelde EssentialsX ve LuckPerms ile birlikte kurulan ilk üç eklentiden biridir.

Bu rehberde mağaza türlerinin farkını, 26.2 uyumlu eklentilerin gerçek durumunu, QuickShop-Hikari’nin adım adım kurulumunu ve en sık takılınan ProtocolLib tuzağını anlatıyoruz. Genel eklenti yükleme mantığını bilmiyorsanız önce plugin kurulumu rehberini okumanız işinizi kolaylaştırır.

Shop Eklentisi Ne Yapar, Hangi Tür Mağaza Size Uygun?#

Mağaza eklentileri iki ana yaklaşımı kullanır ve seçiminiz sunucunuzun oyun moduna göre değişir.

Sandık mağazası (chest shop)#

Oyuncu bir sandık (chest) yerleştirir, üstüne tabela (sign) asar veya bir komut yazar; sandık artık dükkândır. Diğer oyuncular sandığa sağ tıklayarak satın alır, sol tıklayarak satar. Stok gerçektir: sandıkta ürün bittiğinde satış durur. QuickShop-Hikari ve ChestShop bu grupta yer alır. Survival ve skyblock sunucularının vazgeçilmezidir çünkü oyuncular arası gerçek ticaret üretir.

GUI mağazası (menü mağazası)#

Oyuncu /shop yazar, ekranda kategorili bir envanter menüsü açılır ve listeden alışveriş yapar. Stok sınırsızdır, fiyatları yönetici belirler. ShopGUI+ ve EconomyShopGUI bu grubun bilinen örnekleridir. Minigame ve prison sunucularında pratiktir, ama oyuncular arası ticaret üretmez.

Kurulumdan Önce Hazır Olması Gereken Zincir#

Mağaza eklentisi zincirin son halkasıdır. Aşağıdaki bileşenler sırayla kurulu olmalı, aksi hâlde eklenti hiç yüklenmez.

26.2 İçin Mağaza Eklentisi Karşılaştırması#

26.1’in unobfuscation (kod adlarının açılması) değişikliği eklenti ekosistemini ikiye böldü. Eski jar’lar yeniden derlenmeden çalışmadığı için mağaza eklentilerinin çoğu hâlâ geçiş sürecinde. 12 Ağustos 2026 itibarıyla doğrulanmış tablo şu:

QuickShop-Hikari Kurulumu: Adım Adım#

1. Sunucuyu tamamen durdurun#

   Konsola stop yazın veya panelden Durdur düğmesine basın. Çalışan sunucuya jar atmak eklentiyi yüklemez, yalnızca dosya kilidi sorunu çıkarır.

2. Bağımlılıkları plugins klasörüne kopyalayın#

   Önce VaultUnlocked, PacketEvents, LuckPerms ve ekonomi eklentisini atın. QuickShop’u en son ekleyin; ilk açılışta bağımlılıkları görmesi gerekir. Panel kullanıyorsanız web panelden plugin yükleme adımlarını izleyebilirsiniz.

3. QuickShop-Hikari jar dosyasını ekleyin#

   plugins/
   ├── VaultUnlocked-2.20.2.jar
   ├── packetevents-spigot-2.13.0.jar
   ├── LuckPerms-Bukkit-5.5.71.jar
   ├── EssentialsX.jar
   └── QuickShop-Hikari-6.3.0.1.jar

4. Sunucuyu başlatın ve konsolu okuyun#

   Açılışta QuickShop hangi ekonomi sağlayıcısını bulduğunu ve hangi görüntüleme protokolünü kullandığını yazar. Konsolda kırmızı satır varsa devam etmeyin, log okuma rehberindeki yöntemle hatayı ayıklayın.

5. Kurulumu doğrulayın#

   /pl
   qs

   /pl çıktısında QuickShop-Hikari yeşil görünmeli, konsolda qs komutu eklentinin sürüm ve durum özetini basmalıdır.

ProtocolLib Tuzağı ve display-protocol Ayarı#

QuickShop-Hikari, sandığın üstünde dönen ürün görselini çizmek için bir paket kütüphanesi ister ve iki seçenek sunar: ProtocolLib veya PacketEvents. İnternetteki eski rehberlerin neredeyse tamamı ProtocolLib der; 26.2’de bu yanlıştır.

PacketEvents kurduktan sonra ayarı elle belirtmeniz gerekir. Sunucuyu durdurun, plugins/QuickShop-Hikari/config.yml dosyasını açın ve shop bloğunu şu hâle getirin:

shop:
  display-protocol: 'packetevents'
  display-type: 3
  display-items: true
  find-distance: 100
  auto-sign: true
  sign-material: OAK_WALL_SIGN

display-type: 3, 6.3.0.0 “Orion: Rigel” ile gelen display entity tabanlı yeni görüntüleme tipidir ve eski armor stand yöntemine göre çok daha az kaynak tüketir. Binlerce mağazası olan bir sunucuda görselleri tamamen kapatmak isterseniz display-items: false yapmanız yeterli; mağazalar çalışmaya devam eder.

Mağaza İzinlerini LuckPerms ile Dağıtma#

Kurulum bitince hiçbir oyuncu mağaza açamaz, çünkü izinler varsayılan olarak kapalıdır. QuickShop-Hikari basit ve ayrıntılı olmak üzere iki izin modeli sunar. Yeni sunucular için basit model yeterlidir: iki toplu düğüm verirsiniz, eklentiye yeni bir izin eklendiğinde otomatik olarak kapsanır.

/lp group default permission set quickshop.player true
/lp group moderator permission set quickshop.moderator true

Bir izni geri almak veya zorla kapatmak isterseniz kalıp aynıdır:

/lp group <grup> permission unset <izin>
/lp group <grup> permission set <izin> false

Mağaza Açma, Fiyat Verme ve Günlük Komutlar#

Oyuncu tarafında akış çok basittir: sandığı koy, sandığa bak, komutu yaz. Yönetici tarafında ise sınırsız stoklu admin mağazaları kurulur.

Sandığa sağ tıklamak satın alma, sol tıklamak satış işlemidir. Mağazayı kapatmak için sandığı kırmak yeterlidir; içindeki eşyalar sahibine kalır. Mağaza tabelasını dekoratif bir hologramla desteklemek isterseniz hologram ekleme rehberine, mağaza başına NPC koymak isterseniz Citizens ile NPC oluşturma sayfasına bakın.

GUI Mağaza İstiyorsanız Durum Nedir?#

/shop yazınca açılan menü mağazası, yeni oyuncular için en anlaşılır arayüzdür. Ne yazık ki 26.2’de bu tarafın durumu net değil.

ShopGUI+ ücretli bir eklentidir ve SpigotMC’deki kaynak başlığı 18 Ağustos 2026 itibarıyla hâlâ 1.8–1.21 aralığını gösteriyor. 26.x desteği yalnızca geliştiricinin Discord sunucusundaki dev yapılarında bulunuyor. Para verip kararsız bir yapı almak yerine beklemek daha mantıklı.

EconomyShopGUI ücretsiz sürümüyle iyi bir alternatif, ancak sürüm geçmişinde net olarak doğrulanabilen en yüksek destek 26.1.1. 26.2 için açık bir destek notu yok. Kullanacaksanız önce boş bir test sunucusunda deneyin, canlı sunucuya doğrudan atmayın.

Fiyat Belirleme: Mağazanın Piyasayı Bozmaması İçin#

Yeni sunucuların en sık yaptığı hata, admin mağazasına gelişigüzel fiyat yazmaktır. Mağaza sadece bir arayüz değil, sunucu ekonomisinin fiyat tabanıdır; oyuncular kendi sandık mağazalarını buradaki rakamlara bakarak fiyatlar.

Uygulanabilir üç kural var:

• Alış ve satış makası açık olsun. Sunucunun oyuncudan aldığı fiyat, oyuncuya ödediğinin en az iki katı olmalı. 10 birime satıyorsanız 5 birime alın. Makas kapanırsa oyuncular aynı eşyayı alıp satarak sonsuz para üretir.
• Kolay üretilen eşyaya düşük fiyat verin. Otomatik tarla veya mob farm (canavar çiftliği) ile saatte binlercesi üretilebilen bir ürünü yüksek fiyattan satın alırsanız birkaç gün içinde piyasada karşılığı olmayan bir para yığını oluşur.
• Sınırsız stoklu satın alma mağazası açmayın. Admin mağazasının satış yönü (sunucu oyuncudan alır) sınırsız olduğunda para basma makinesi hâline gelir. Alım yönüne günlük limit koyun ya da yalnızca satış yönünü açık bırakın.

Sık Karşılaşılan Hatalar ve Çözümleri#

Eklenti hiç yüklenmiyor#

Bağımlılık eksikse Paper eklentiyi hiç başlatmaz ve konsola şu kalıbı basar:

Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'AnnouncerPlus'

Köşeli parantez içindeki eklentiyi plugins klasörüne koyup sunucuyu tam olarak yeniden başlatın; /reload bu durumu düzeltmez. Ayrıntılı ayıklama için “Could Not Load Plugin” hatası çözümüne bakabilirsiniz.

Eklenti yükleniyor ama komut verince patlıyor#

26.1 ile gelen unobfuscation sonrası NMS kullanan eski eklentiler farklı davranır: konsolda “Could not load” görmezsiniz, eklenti yeşil görünür, ama ilk kullanımda NoSuchMethodError veya NoClassDefFoundError ile çöker. Bu tabloyu görüyorsanız eklentinin 26.2 için yeniden derlenmiş sürümünü indirmeniz gerekir; yapılandırma değişikliği sorunu çözmez.

Ürün görselleri görünmüyor#

Sandığın üstünde dönen eşya yoksa önce display-protocol ayarını kontrol edin. PacketEvents kurulu ama ayar hâlâ protocollib yazıyorsa görseller çizilmez. Ayarı düzeltip sunucuyu yeniden başlatın.

Bakiye görünmüyor, işlem yapılamıyor#

Vault köprüsü var ama arkasında ekonomi eklentisi yoksa bakiye hep sıfır kalır. EssentialsX kuruluysa ekonomi otomatik olarak Vault’a kaydolur, ek ayar gerekmez. Doğrulamak için oyun içinde /balance yazın; komut tanınmıyorsa ekonomi eklentiniz yüklenmemiştir.

Donanım: Mağazalı Sunucu Ne İster?#

Mağaza eklentisi kendi başına ağır değildir, ama binlerce sandık mağazası veritabanı sorgusu ve entity yükü üretir. Sunucunun ana tick döngüsü tek çekirdekte çalıştığı için burada belirleyici olan çekirdek sayısı değil saat hızıdır.

Mağaza verilerini SQLite yerine MySQL’de tutmak, 500’den fazla mağazası olan sunucularda okuma gecikmesini azaltır; kurulumu MySQL bağlama rehberinde anlatılıyor. Hazır altyapı isterseniz Batihost’un Minecraft sunucu paketleri Ryzen 9 işlemci ve NVMe disk ile 156 TL’den başlıyor.

Özetle#

26.2 sunucusunda mağaza kurmanın kararlı yolu QuickShop-Hikari 6.3.0.1’dir. Önce VaultUnlocked, PacketEvents, LuckPerms ve bir ekonomi eklentisi kurun, sonra QuickShop jar’ını ekleyin. Kurulumdan sonra yapılacak iki kritik iş var: config.yml içinde display-protocol değerini packetevents yapmak ve quickshop.player iznini default grubuna vermek. GUI mağaza tarafı 26.2’de henüz oturmadığı için ShopGUI+ ve EconomyShopGUI’yi canlı sunucuya doğrudan atmayın.

Mağaza yalnızca yarısıdır; paranın nereden gelip nereye gittiğini planlamadan ekonomi kurulmuş sayılmaz. Devamı için ekonomi sistemi kurma rehberine geçin.