Minecraft eklentisi ChestShop

🔌 ChestShop hakkında

ChestShop, sandıklar ve tabelalar kullanarak oyuncu tarafından işletilen mağazalar oluşturmak için bir Minecraft eklentisidir. Mağaza işlemlerini sunucu ekonomisine (Vault veya Reserve üzerinden) bağlar, böylece oyuncular sunucunun parasını kullanarak eşya alıp satabilir. Proje GitHub’da sürdürülür ve build’leri yaygın eklenti platformları üzerinden dağıtır.

🎯 Amaç

Oyuncuların bir sandığa tabela yerleştirerek mağaza oluşturduğu, basit ve kalıcı bir oyun içi pazar yeri sunmak. ChestShop, oyuncu envanterleri ile sunucu ekonomisi arasındaki işlemleri yönetir ve griefing’i ve entegrasyon işini azaltmak için koruma ve uyumluluk hook’ları içerir.

⚙️ Özellikler

• Bir sandığa biçimlendirilmiş bir tabela yerleştirerek satın alma/satış mağazaları oluşturma.
• Para yönetimi için Vault veya Reserve ve diğer uyumlu ekonomi eklentileriyle entegrasyon.
• Yaygın sandık koruma eklentilerini dikkate alan mağaza koruması ve uyumluluk seçenekleri.
• Yazarlar tarafından belgelenmiş anti-lag / işlem güvenliği önlemleri.
• Topluluk eklentileri ve uyumluluk eklentileri ile genişletilebilir (eklenti listesi proje tarafından tutulur).
• Son sürümlerde yönetici ve bilgi komutları eklendi (örnekler: /shopinfo, /iteminfo).

🧩 Kimler için

• Para tabanlı ekonomi kullanan Survival ve SMP sunucuları.
• GUI vitrinleri yerine basit, tabela tabanlı oyuncu mağazaları isteyen sunucular.
• Temel mağaza depolaması için zorunlu veritabanı olmadan eşyaları normal sandıklarda tutan mağazaları tercih eden yöneticiler.

🏗️ Örnek kullanım senaryoları

• Oyuncular bir sandık yerleştirir, satacakları eşyayı koyar ve alış/satış fiyatlarını belirlemek için bir tabela oluşturur; diğer oyuncular ticaret yapmak için tabelaya tıklar.
• Sunucu yöneticileri, sunucu tarafından yürütülen eşya satışları için yönetici mağazaları oluşturur.
• Bir topluluk, ChestShop’u bir koruma veya gösterim eklentisiyle entegre etmek için bir uyumluluk eklentisi ekler.

⌨️ Komutlar

(Listelenen komutlar, projenin sürüm notları ve belgelerinden alınmıştır. Yalnızca proje tarafından açıkça belgelenmiş komutlar gösterilir.)

🔐 İzinler

(İzin düğümleri yalnızca resmi proje kaynaklarında ve sürüm notlarında göründükleri yerlerde dahil edilir.)

⚙️ Kurulum

📥 Kurulum

• Resmi ChestShop .jar dosyasını indirin ve sunucunun plugins/ klasörüne yerleştirin.
• Vault veya Reserve ile, para API’si sağlayan uyumlu bir ekonomi eklentisi kurun.
• Sunucuyu yeniden başlatın ve ChestShop’un başarıyla etkinleştiğini doğrulamak için sunucu konsolunu kontrol edin.

📦 Bağımlılıklar

• Vault (entegrasyon desteklenir) veya Reserve (entegrasyon desteklenir)
• Para API’si sunan uyumlu bir ekonomi eklentisi (Vault/Reserve ile birlikte kurulur)

🧾 Yapılandırma

Eklenti ilk çalıştırmada configuration/yml dosyaları oluşturur; yapılandırma seçenekleri ve uyumluluk anahtarları bu dosyalarda ve proje belgelerinde bulunur.

🧠 Teknik Notlar

• Kaynak kodu ve hata takibi GitHub’da LGPL-2.1 lisansı altında barındırılır.
• Proje, yaygın eklenti sitelerinde build’leri ve sürüm çıktılarını listeler; bakımcılar ayrıca bir CI sunucusunda geliştirme build’leri yayımlar.
• ChestShop, Bukkit/Spigot/Paper sunucu türleri için tasarlanmıştır (proje belgeleri ve depo bunu açıkça belirtir).

🤝 Bu eklenti ne zaman kullanışlıdır

Eşyaların sade sandıklarda kaldığı ve işlemlerin sunucu paranızı kullandığı, doğrudan bir oyun içi pazar yeri istiyorsanız ChestShop, ekonomi entegrasyonu ve add-on uyumluluğu ile olgun ve genişletilebilir bir sandık-ve-tabela mağaza sistemi sunar.