Minecraft eklentisi QuickShop-Hikari

🔌 QuickShop-Hikari hakkında

QuickShop-Hikari, sandık tabanlı alım/satım mağazaları (ChestShops) uygulayan bir Minecraft eklentisidir. Oyuncular, sandıklarla etkileşime geçerek mağaza oluşturur ve kullanır; oynanışın büyük kısmı için komut gerekmez. Proje, QuickShop-Community tarafından sürdürülür ve modern uyumluluk, veri güvenliği ve genişletilebilir entegrasyonlara odaklanır.

🎯 Amaç

Oyuncuların eşyaları satışa koyabildiği veya sandıkları kullanarak alım mağazaları oluşturabildiği, oyun içi ve eşya tabanlı bir ekonomi sağlamak. Eklenti, oyunculara komut öğretmeye zorlamadan fiziksel, sandık odaklı bir ekonomi ve mağaza bazında kontrol isteyen sunucu yöneticileri için tasarlanmıştır.

⚙️ Özellikler

• Sandıklar ve tabelalar kullanarak alım ve satım mağazaları oluşturma (sandık tabanlı mağazalar).
• NBT verisi, büyüler, eşya hasarı, iksir verisi ve mob yumurtaları desteği.
• Mağazaların üstünde açılıp kapatılabilen sanal gösterim öğesi (ProtocolLib veya PacketEvents desteklenir).
• Sınırsız sandık desteği ve çift sandıkta karışık alım/satım davranışı.
• Atlama (bypass) izin seçenekleriyle blacklist desteği.
• Mağaza bazında izin yönetimi ve sahipler ile diğer oyuncular arasında mağaza avantajları.
• Eşya ve büyü adları için i18n desteği ve mesajlar için MiniMessage sözdizimi.
• H2 (yerel) ve MySQL (uzak) veri kaynağı desteği.
• Yaygın koruma ve yardımcı eklentiler için entegrasyon kancaları (uyumluluk modülleri mevcut).
• Mağazaları sorgulamak ve özellikleri entegre etmek için geliştirici API’si (Maven/Gradle koordinatları sağlanır).
• Yapılandırma üzerinden kapatılabilen bStats telemetrisi.

🧩 Kimler için

Survival/SMP veya ekonomi odaklı sunucular çalıştıran ve fiziksel, sandık tabanlı bir pazar isteyen sunucu sahipleri ve yöneticileri için uygundur. Vault uyumlu ekonomi eklentileri kullanan, mağaza bazında kontrol ve veritabanı destekli depolama isteyen küçükten büyüğe tüm sunuculara uygundur.

🏗️ Örnek kullanım senaryoları

• Oyuncular bir sandığa eşyalar koyup etiketleyerek paketleri otomatik olarak diğer oyunculara satabilir.
• Bir yönetici, moderatörlerin belirli dünyalarda veya bölgelerde mağazaları yönetebilmesi için mağaza bazında izinleri etkinleştirir.
• Bir ağ, mağazaları sunucu örnekleri arasında kalıcı tutmak için MySQL depolaması kullanır.

⌨️ Komutlar

Not: Proje dokümantasyonuna göre normal oyuncu oynanışı komut gerektirmez; komutlar esas olarak yönetim amaçlıdır.

🔐 İzinler

⚙️ Kurulum

📥 Kurulum

• Projenin dağıtımından resmi QuickShop-Hikari jar dosyasını indirin (Modrinth/Spigot/GitHub sürümleri).
• Jar dosyasını sunucunuzun plugins/ klasörüne koyun.
• Sunucuyu başlatın ve eklentinin yüklendiğini doğrulayın (dokümantasyonda, yardım/test çıktısını göstermek için konsolda qs komutunun çalıştırılması gösterilir).

📦 Bağımlılıklar

Proje tarafından listelenen doğrulanmış gerekli/isteğe bağlı entegrasyonlar:

• Vault (ekonomi köprüsü için gerekli)
• Vault uyumlu bir ekonomi eklentisi (proje tarafından verilen örnekler)
• ProtocolLib veya PacketEvents (sanal gösterim öğeleri / oyuncu bazlı yerelleştirme için gerekli)
• LuckPerms (izin yönetimi için önerilir)

🧾 Yapılandırma

• Eklenti bir config.yml oluşturur ve kullanır (doküman, gösterim protokolü ve gizlilik ayarları için config.yml anahtarlarına referans verir).
• Veri depolama yerel H2 veya uzak MySQL’i destekler; yapılandırma seçenekleri eklenti yapılandırma dosyalarında mevcuttur.

🧠 Teknik Notlar

• Resmî dokümantasyon, Paper tabanlı bir sunucuda çalıştırmayı önerir ve Java 21 gereksinimini belirtir.
• Proje, derleme zamanı kullanımı için bir geliştirici API’si ve Maven/Gradle koordinatları sağlar.
• QuickShop-Hikari, üçüncü taraf eklentiler için (ör. WorldGuard, WorldEdit, OpenInv) isteğe bağlı indirilebilen uyumluluk modülleriyle gelir.
• Telemetri: bStats kullanır; config ayarlarından kapatılabilir.

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

GUI-only veya komut tabanlı mağazalar yerine kalıcı depolama ve mağaza bazında kontroller sunan, sandık odaklı ve oyuncuya dönük bir pazar istiyorsanız, QuickShop-Hikari yaygın ekonomi ve koruma eklentileri için kancalar içeren modern, veritabanı destekli bir çözüm sunar.