Minecraft eklentisi ExcellentCrates

🔌 ExcellentCrates Hakkında

ExcellentCrates, Spigot/Paper sunucuları için tam özellikli bir crates (lootbox) sistemi लागूlayan bir Minecraft eklentisidir. Yapılandırılabilir crate türleri, anahtar yönetimi (sanal ve fiziksel) ve sunucu yöneticilerinin ağırlıklı olarak oyun içi bir GUI düzenleyici üzerinden yönetebildiği esnek ödül tanımlarına odaklanır.

🎯 Amaç

Bu eklenti, bir sunucuda crate tabanlı ödülleri oluşturma, yapılandırma ve sunma sorununu manuel dosya düzenlemeleri gerektirmeden çözer. Etkinlikler, günlük ödüller, ücretli özellikler veya oyuncu ilerlemesi için ödül crate’leri kullanmak isteyen sunucu sahipleri ve yöneticileri için tasarlanmıştır; yapılandırma ve önizlemeler oyun içinde erişilebilir kalır.

⚙️ Özellikler

• Crate, anahtar ve ödül oluşturmak ve yönetmek için oyun içi GUI düzenleyici.
• Fiziksel ve sanal anahtar desteği (sanal anahtarlar takas/ paylaşımı engeller).
• Crate blokları için yerleşik hologramlar ve parçacık efektleri (bazı hologram özellikleri için isteğe bağlı eklentiler gerekebilir).
• Crate Blocks: crate’leri fiziksel bloklara/bölgelere bağlayarak dünyada crate etkileşimi sağlar.
• Her crate için özel önizleme GUI’leri ve özel açma GUI’leri.
• Ödül türleri: eşya ödülleri ve komut ödülleri.
• Bundle desteği: ödül başına birden fazla eşya yığını (belgelenen sınır, eşya ödülü başına 27 eşyaya kadar) ve komut ödülü başına sınırsız komut.
• Ödül şansını dengelemek için nadirlikler ve ağırlıklar.
• Milestone’lar ve toplu açma işlevi.
• Açma bekleme süresi ve oyuncu başına açma maliyeti (açma maliyeti özelliği ekonomi entegrasyonunu ima eder).
• Crate ve ödüller için izin ve anahtar gereksinimleri.
• Ödül limitleri (genel ve oyuncu başına) ile ödül duyurma/kayıt.
• Resmî kaynakların belirttiği PlaceholderAPI desteği.

🧩 Kimler İçin

• Etkinlikler, para kazanma veya oyuncu etkileşimi için crate kullanan herkese açık ve özel Spigot/Paper sunucuları.
• Manuel YAML düzenlemek yerine oyun içi düzenleyiciyi tercih eden sunucu yöneticileri.

🏗️ Örnek Kullanım Alanları

• Nadirlikler ve ağırlıklı ödüllerle bir crate yapılandırın, spawn bölgesine bir crate bloğu yerleştirin ve oyunculara açmak için sanal anahtarlar verin.
• Oyuncuların anahtar harcamadan önce crate ödüllerini inceleyebilmesi için crate önizlemeleri ve hologramlar oluşturun.
• Sınırlı süreli etkinlikler düzenlemek veya aktif oyuncuları ödüllendirmek için toplu açma ve milestone’ları kullanın.

⚙️ Kurulum

📥 Kurulum

• Resmî eklenti JAR dosyasını indirin ve doğrulanmış desteklenen bir sunucu sürümünde (Spigot veya Paper) sunucunuzun plugins/ dizinine yerleştirin.
• Sunucuyu yeniden başlatın ve eklentinin yüklendiğini doğrulamak için sunucu konsolunu kontrol edin.
• Eklenti yardımcı motor bağımlılığını gerektiriyorsa, gerekli bağımlılık eklentisini (nightcore) ExcellentCrates’ten önce veya onunla birlikte kurun.

📦 Bağımlılıklar

• Gerekli: Resmî kaynaklarda belirtildiği üzere nightcore (eklenti motoru).
• İsteğe bağlı: Gelişmiş hologram işlevselliği için ProtocolLib veya PacketEvents; metinlerdeki yer tutucular için PlaceholderAPI desteklenir.

🧠 Teknik Notlar

• Doğrulanmış desteklenen sunucu yazılımı: Spigot ve Paper.
• Doğrulanmış minimum sunucu sürümü gereksinimi: 1.21.8 veya üzeri (proje tarafından belirtildiği gibi).
• Doğrulanmış Java gereksinimi: Java 21 veya daha yeni.
• Folia ve Forge desteği açıkça sunulmamaktadır.
• Proje deposunda GPL-3.0 lisansı listelenmiştir.

🤝 Bu Eklenti Ne Zaman Kullanışlıdır

Spigot/Paper sunucusu için sanal/fiziksel anahtarlar, hologramlar ve esnek ödül tanımları (eşya, komut, nadirlik ve limitler) içeren, oyun içinde yapılandırılabilen bir crate sistemine ihtiyacınız varsa, ExcellentCrates bu özellikleri ve manuel dosya düzenlemeye gerek kalmadan yapılandırmanın büyük kısmını yönetilebilir tutan bir düzenleyici iş akışını sunar.