Minecraft eklentisi PhoenixCrates

🔌 Phoenix Crates hakkında

Phoenix Crates, bir sunucuda crate/ödül sistemlerini çalıştırmak için kullanılan bir Minecraft eklentisidir. Crate türleri, anahtarlar (fiziksel ve sanal), animasyonlu açılış sıraları ve ham dosyaları düzenlemeden crate ve ödüller oluşturup yönetmek için oyun içi bir düzenleyici sunar. Proje Phoenix Plugins tarafından yayınlanır ve ücretsiz bir sürümün yanı sıra ekstra özellikler içeren ücretli premium sürümle sunulur.

🎯 Amaç

Sunucu yöneticilerine, animasyonlu açılışlar gösterebilen, anahtarları ve sanal para tarzı anahtarları yönetebilen ve ekibin oyun içinde crate ve ödül oluşturup düzenlemesine izin veren yapılandırılabilir bir ödül/crate sistemi sağlamak. Etkinlik tarzı veya mağaza/ödül mekanikleri isteyen sunucular için tasarlanmıştır (örneğin: ödül çekilişleri, mağaza crate’leri veya etkinlik ödülleri).

⚙️ Özellikler

• Birden fazla crate motoru modu (vanilla blok, vanilla model, Model Engine entegrasyonu).
• Yapılandırılabilir aşamalar ve kombinasyonlara sahip animasyonlu açılış sıraları ve bekleme animasyonları.
• Fiziksel anahtarlar ve sanal anahtar yönetimi (sanal anahtar menüleri, ödeme/aktarma, ver/al/ayarla komutları).
• Crate, anahtar, ödül ve animasyon oluşturmak/düzenlemek için oyun içi düzenleyici.
• Rastgele ve seçmeli (oyuncunun seçtiği) ödüller, yeniden çekimler ve garantili ödüller dahil ödül türleri.
• Eklentiler ve premium ek özellikler (ek animasyonlar, MySQL desteği, API ve premium planda eklenti kurulumu).
• Belirli animasyonlar ve modeller için temel Bedrock/Geyser görüntüleme desteği.
• Sunucu tarafı ön izleme ve ödül yönetimi araçları (genel/oyuncu kazanma sınırları, bekleme süresi sıfırlamaları).

🧩 Kimler için

• Crate veya ödül sistemleri sunan Survival/SMP ve ekonomi sunucuları.
• Animasyonlu/görsel crate açılışları ve model desteği (Model Engine) isteyen sunucular.
• Manuel dosya düzenlemek yerine crate kurulumunda oyun içi düzenleyiciyi tercih eden yöneticiler.

🏗️ Örnek kullanım alanları

• Oyunculara, kozmetik veya eşya crate’lerini açmak için bir GUI’de harcayabilecekleri sanal anahtarlar vermek.
• Özel açılış animasyonları ve sınırlı ödüllerle tatil temalı crate’ler oluşturmak.
• YAML’ı elle düzenlemeden crate kurulumlarını taşımak veya yeniden oluşturmak için oyun içi düzenleyiciyi kullanmak.

⌨️ Komutlar

(Yukarıdaki komutlar, resmi Phoenix Crates dokümantasyonundan ve komut referansından alınmıştır.)

🔐 İzinler

(Sadece proje tarafından açıkça belgelenen izin düğümleri listelenmiştir.)

⚙️ Kurulum

📥 Ayarlama

• Resmî Phoenix Crates eklenti JAR’ını indirin veya resmî dağıtım kanalından edinin.
• JAR dosyasını desteklenen bir sunucu için sunucunuzun plugins/ dizinine yerleştirin (bkz. Teknik Notlar).
• Sunucuyu başlatın veya yeniden başlatın ve eklentinin yüklendiğini doğrulamak için konsolu kontrol edin.
• Crate ve anahtarlar oluşturmak için oyun içi düzenleyiciyi veya sağlanan komutları kullanın; eklenti ayrıca yeniden yükleme ve düzenleyici komutları da sunar.

📦 Bağımlılıklar

• Varsayılan olarak gerekli bir üçüncü taraf bağımlılık listelenmez. Eklenti, özel modeller için Model Engine gibi isteğe bağlı sistemlerle entegre olur ve değişiklik kayıtlarında belirtilen placeholder’ları sağlar.

🧠 Teknik Notlar

• Desteklenen sunucu yazılımları (yazarın belirttiği şekilde): Spigot ve Spigot forkları, Paper ve Paper forkları ve Folia.
• Desteklenen Minecraft sürümleri: belgede belirtildiği üzere Phoenix Crates (belirtilen sürüm satırı itibarıyla) Minecraft 1.20.4+ destekler (eski sürümlerin desteği belirtilen büyük sürümle birlikte kaldırılmıştır).
• İsteğe bağlı entegrasyonlar: Model Engine (özel animasyonlu modeller), Bedrock görüntüleme için GeyserMC uyumluluk notları ve güncellemelerde bahsedilen PlaceholderAPI placeholder’ları.
• Proje ücretsiz ve premium katmanlarda sunulur; premium, MySQL desteği, herkese açık API erişimi, sınırsız crate, ek animasyonlar ve eklentiler gibi özellikler ekler.

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

Yapılandırılabilir, animasyon odaklı bir crate sistemine, oyun içi bir düzenleyiciye ve isteğe bağlı model/Bedrock desteğine ihtiyacınız varsa, Phoenix Crates hem oyuncuya yönelik görselleri hem de sunucudan ödülleri ve anahtarları yönetmek için yönetici araçlarını sağlar.