Tanıtım🐉 AgiraCrates — Gelişmiş Minecraft Kasa Sistemi

[kursattbektas]

Minecraft Sürümleri

1.21.11

ItemsAdder Destekli • Çoklu Animasyon • Güvenli Anahtarlar • Türkçe ve İngilizce​

AgiraCrates, Minecraft sunucuları için geliştirilen, özelleştirilebilir ve modüler bir kasa (Crates) eklentisidir. AgiraLib altyapısını kullanan sistem, klasik kasa eklentilerinin ötesine geçerek özel 3D modeller, animasyonlar, ödül yönetimi, hologramlar ve güvenlik mekanizmalarını tek çatı altında birleştirmeyi amaçlamaktadır.

Geliştirme Durumu: Aktif geliştirme / Test sürümü
Son Sürüm: v1.3 LanguageSafe
Hedef Minecraft Sürümleri: 1.16.5 ve üzeri
Test Edilen Sürüm: Paper 1.21.11
Platform: Paper öncelikli
Dil Desteği: Türkçe ve İngilizce
Entegrasyon: ItemsAdder
Altyapı: Java, Gradle, SQLite

---

1. Modüler Plugin Altyapısı​

• AgiraCrates: Kasa, ödül, animasyon ve oyuncu işlemlerini yönetir.
• AgiraLib: Ortak fonksiyonlar, eşya işlemleri ve ItemsAdder entegrasyonunda kullanılır.
• Modüler Java proje yapısı.
• Gradle ile derlenebilir kaynak kodları.
• YAML üzerinden yapılandırma.
• SQLite tabanlı veri saklama.
• Sunucu sürümleri arasındaki uyumluluğu artırmayı hedefleyen yapı.

2. Kasa Yönetim Sistemi​

• Sınırsız sayıda kasa tanımlayabilmeye yönelik yapı.
• Oyun içerisinden yeni kasa oluşturma.
• Kasa ismini ve simgesini değiştirme.
• Kasa ayarlarını GUI üzerinden yönetme.
• Bütün kasaları tek bir yönetim menüsünde listeleme.
• Sayfalı kasa yönetim paneli.
• Kasa silme ve onay ekranı.
• Kasaları dünyadaki bloklara veya mobilyalara bağlama.
• Kasa bağlantısını model veya blok silinmeden kaldırma.
• Kasa ayarlarını YAML dosyalarında saklama.

3. Kasa Etkileşimleri​

• Sağ tık: Anahtar kullanarak kasa açma.
• Sol tık: Ödül önizleme menüsünü görüntüleme.
• Shift + Sol tık: Yönetici yetkisiyle kasa bağlantısını kaldırma.
• Kasa işlemlerine özel yetki kontrolleri.
• Aynı etkileşimin iki kez işlenmesini önlemeye yönelik kontroller.
• Normal çevre bloklarının yanlışlıkla kasa olarak algılanmasını engelleyen düzeltmeler.

4. Gelişmiş Kasa Animasyonları​

Beş farklı animasyon türü:

1. ROULETTE: Ödüllerin yatay olarak hareket ettiği klasik rulet.
2. PULSE: Renk değiştiren panellerle merkezde ödül gösterimi.
3. MYSTERY: Gizemli kartlar ve sürpriz ödül gösterimi.
4. SPIRAL: Döngüsel, spiral görünümlü ödül animasyonu.
5. CASCADE: Kademeli değişen envanter animasyonu.

Ek görsel özellikler:

• Animasyon süresi ayarlama.
• Animasyon sonunda yavaşlama.
• Nadirliğe göre değişen cam panel renkleri.
• Kasa açılış sesleri.
• Kazanma parçacık efektleri.
• Özel sonuç ekranları.
• Kasa bazında farklı animasyon seçimi.

5. Ödül ve Nadirlik Sistemi​

Beş farklı ödül nadirliği:

• COMMON: Sıradan — Beyaz.
• RARE: Nadir — Açık mavi.
• EPIC: Epik — Mor.
• LEGENDARY: Efsanevi — Turuncu.
• MYTHIC: Mitik — Magenta.

Ödül özellikleri:

• Minecraft eşyalarını ödül olarak tanımlama.
• ItemsAdder özel eşyalarını ödül olarak kullanma.
• Konsol komutuyla ödül verme.
• Büyülü ve özel isimli eşyaların meta bilgilerini saklama.
• Ödül miktarı düzenleme.
• Ödül ekleme ve silme.
• Sayfalı ödül listesi.
• Ödül nadirliği değiştirme.
• Kazanma şansını yüzdelik olarak gösterme.
• Ödül yüzdelerini toplam %100 üzerinden düzenleme.
• Nadirliğe göre görsel efekt uygulama.

6. Fiziksel ve Sanal Anahtar Sistemi​

• Kasa türüne özel fiziksel anahtarlar.
• SQLite destekli sanal anahtar bakiyesi.
• Oyuncuya anahtar verme komutları.
• Anahtar bakiyesi kontrolü.
• ItemsAdder özel anahtar modelleri.
• Anahtar doğrulama sistemi.
• Fiziksel anahtarlar için HMAC-SHA256 imzalama.
• Anahtarlara benzersiz UUID tanımlama.
• Kullanılmış anahtarları kayıt üzerinden yeniden kullanıma kapatma.
• Aynı anda birden fazla kasa açılışına yönelik güvenlik kontrolleri.

7. ItemsAdder ve 3D Kasa Entegrasyonu​

• ItemsAdder mobilyalarını kasa olarak kullanabilme.
• Özel 3D kasa modelleriyle etkileşim.
• ArmorStand tabanlı mobilya desteği.
• ItemsAdder mobilya etkileşim olayları için entegrasyon.
• Mobilyanın farklı yüzeylerinden etkileşimi desteklemeye yönelik düzeltmeler.
• Mobilya ile kasa kimliği eşleştirme.
• ItemsAdder özel anahtar ve ödül modelleri.
• Normal Minecraft kasalarıyla birlikte kullanım.

Not: Gerçek model kapağının açılıp kapandığı 3D animasyonlar henüz geliştirme hedefleri arasındadır.

8. Hologram Sistemi​

• Kasa üzerinde hologram gösterimi.
• Kasa ismi ve ödül sayısı görüntüleme.
• Anahtar gereksinimi bilgisi.
• Kasa bazında hologram açma ve kapatma.
• YAML üzerinden hologram satırları.
• Hologram yükseklik ayarı.
• %crate%, %id%, %rewards% değişkenleri.
• Ayrı hologram plugini zorunluluğu olmadan ArmorStand isim etiketleri üzerinden çalışma.

9. Güvenlik ve Ödül Teslim Sistemi​

• SQLite işlem kayıtları.
• Kasa açma sırasında ödülün önceden belirlenmesi.
• Ödül teslim durumu takibi.
• Sanal anahtar tüketiminde veritabanı işlemleri.
• İmzalı fiziksel anahtar doğrulaması.
• Tekrar kullanım kontrolleri.
• Oyuncu bazında eşzamanlı kasa açılışı engelleme.
• Bekleyen ödüller için teslim komutu.
• Envanteri dolu oyunculara yönelik ödül teslim kuyruğu.
• Sunucu kapanması sırasında belirsiz kalan teslimatları yönetici incelemesine yönlendirme.
• Yönetici anahtar dağıtım kayıtları.

Güvenlik durumu: Bu mekanizmalar geliştirilmiş olmakla birlikte tüm eşzamanlılık, sunucu çökmesi ve veri kurtarma senaryoları bağımsız olarak doğrulanmamıştır. Özellikle fiziksel envanter işlemleriyle SQLite arasında tam atomiklik garantisi bulunmamaktadır.

10. Türkçe ve İngilizce Dil Sistemi​

• tr_TR.yml Türkçe dil dosyası.
• en_US.yml İngilizce dil dosyası.
• İngilizce standart komutlar.
• Yapılandırmadan dil seçimi.
• Oyuncu mesajlarını özelleştirme.
• GUI başlıklarını ve açıklamalarını çevirme altyapısı.
• Hologram metinlerini düzenleme.
• Renk kodlarını destekleyen mesajlar.
• Noktalama işaretli çeviriler için güvenli from / to yapısı.
• Dil dosyası yükleme hatalarında kayıt ve geri dönüş mekanizması.

Dil sistemi aktif olarak geliştirilmektedir; bazı dinamik metinlerin çeviri kapsamı ayrıca test edilmektedir.

11. Komut Sistemi​

Temel komutlar İngilizce standardına geçirilmiştir.

Komut	Açıklama
/crates editor	Kasa yönetim paneli
/crates create <id>	Yeni kasa oluşturma
/crates open <id>	Kasa açma
/crates preview <id>	Ödül önizleme
/crates givekey <player> <id> <amount>	Fiziksel anahtar verme
/crates givevirtual <player> <id> <amount>	Sanal anahtar verme
/crates bindfurniture <id>	Mobilyayı kasaya bağlama
/crates hologram <id> on/off	Hologram kontrolü
/crates claim	Bekleyen ödülleri teslim alma
/crates reload	Yapılandırmayı yeniden yükleme

Komutlar yetkilere ve ilgili kasa ayarlarına göre çalışır.

---

Geliştirme Yol Haritası​

Planlanan sonraki özellikler:

• Gerçek 3D kasa kapağı animasyonları.
• Gelişmiş Pity (garanti ödül) sistemi.
• Toplu kasa açma.
• Animasyon atlama seçenekleri.
• Kasa açılış istatistikleri.
• Ayrıntılı oyuncu geçmişi.
• Ödül stok ve limitleri.
• Vault ekonomi entegrasyonu.
• PlaceholderAPI entegrasyonu.
• MySQL/MariaDB desteği.
• Özel kasa etkinlikleri.
• Ödül koleksiyon sistemi.
• Geliştiriciler için genişletilmiş API.
• Farklı Minecraft sürümlerinde kapsamlı otomatik testler.

---

Proje Durumu​

AgiraCrates, aktif olarak geliştirilen özel bir Minecraft kasa eklentisidir.

Geliştirme sürecinde Paper 1.21.11 üzerinde kasa oluşturma, ödül dağıtma, animasyonlar, ItemsAdder mobilya etkileşimleri ve hologramlar gibi temel özellikler oyun içerisinde test edilmiştir.

Son güvenlik ve dil altyapısı güncellemelerinin tamamı ise henüz kapsamlı üretim testlerinden geçirilmemiştir.

Hedefimiz; performanslı, esnek, görsel açıdan gelişmiş ve sunucu yöneticilerinin kolayca kullanabileceği profesyonel bir kasa sistemi ortaya çıkarmaktır.

AgiraCrates — Kasadan daha fazlası.

GİF KALİTELERİ İÇİN KUSURA BAKMAYIN GELİŞTİRME İŞİ BİTİNCE DAHA KAPSAMLI VE KALİTELİ BİR VİDEOYU YOUTUBE'DA PAYLAŞACAĞIM..

 

[Mitoristik]

Projeden görsel ekler misiniz lütfen.

 

[kursattbektas]

Projeden görsel ekler misiniz lütfen.

ilgili medyayı konuya ekledim ikazınız için teşekkür ederim...

 

[Wisarts]

Claude'a bunu yaptırmaktansa SpecializedCrates leak indirir içindeki ratı Claude'a temizletir kullanırım daha iyi.

 

[teknolojitamirci]

ItemsAdder Destekli • Çoklu Animasyon • Güvenli Anahtarlar • Türkçe ve İngilizce​

AgiraCrates, Minecraft sunucuları için geliştirilen, özelleştirilebilir ve modüler bir kasa (Crates) eklentisidir. AgiraLib altyapısını kullanan sistem, klasik kasa eklentilerinin ötesine geçerek özel 3D modeller, animasyonlar, ödül yönetimi, hologramlar ve güvenlik mekanizmalarını tek çatı altında birleştirmeyi amaçlamaktadır.

Geliştirme Durumu: Aktif geliştirme / Test sürümü
Son Sürüm: v1.3 LanguageSafe
Hedef Minecraft Sürümleri: 1.16.5 ve üzeri
Test Edilen Sürüm: Paper 1.21.11
Platform: Paper öncelikli
Dil Desteği: Türkçe ve İngilizce
Entegrasyon: ItemsAdder
Altyapı: Java, Gradle, SQLite

---

1. Modüler Plugin Altyapısı​

• AgiraCrates: Kasa, ödül, animasyon ve oyuncu işlemlerini yönetir.
• AgiraLib: Ortak fonksiyonlar, eşya işlemleri ve ItemsAdder entegrasyonunda kullanılır.
• Modüler Java proje yapısı.
• Gradle ile derlenebilir kaynak kodları.
• YAML üzerinden yapılandırma.
• SQLite tabanlı veri saklama.
• Sunucu sürümleri arasındaki uyumluluğu artırmayı hedefleyen yapı.

2. Kasa Yönetim Sistemi​

• Sınırsız sayıda kasa tanımlayabilmeye yönelik yapı.
• Oyun içerisinden yeni kasa oluşturma.
• Kasa ismini ve simgesini değiştirme.
• Kasa ayarlarını GUI üzerinden yönetme.
• Bütün kasaları tek bir yönetim menüsünde listeleme.
• Sayfalı kasa yönetim paneli.
• Kasa silme ve onay ekranı.
• Kasaları dünyadaki bloklara veya mobilyalara bağlama.
• Kasa bağlantısını model veya blok silinmeden kaldırma.
• Kasa ayarlarını YAML dosyalarında saklama.

3. Kasa Etkileşimleri​

• Sağ tık: Anahtar kullanarak kasa açma.
• Sol tık: Ödül önizleme menüsünü görüntüleme.
• Shift + Sol tık: Yönetici yetkisiyle kasa bağlantısını kaldırma.
• Kasa işlemlerine özel yetki kontrolleri.
• Aynı etkileşimin iki kez işlenmesini önlemeye yönelik kontroller.
• Normal çevre bloklarının yanlışlıkla kasa olarak algılanmasını engelleyen düzeltmeler.

4. Gelişmiş Kasa Animasyonları​

Beş farklı animasyon türü:

1. ROULETTE: Ödüllerin yatay olarak hareket ettiği klasik rulet.
2. PULSE: Renk değiştiren panellerle merkezde ödül gösterimi.
3. MYSTERY: Gizemli kartlar ve sürpriz ödül gösterimi.
4. SPIRAL: Döngüsel, spiral görünümlü ödül animasyonu.
5. CASCADE: Kademeli değişen envanter animasyonu.

Ek görsel özellikler:

• Animasyon süresi ayarlama.
• Animasyon sonunda yavaşlama.
• Nadirliğe göre değişen cam panel renkleri.
• Kasa açılış sesleri.
• Kazanma parçacık efektleri.
• Özel sonuç ekranları.
• Kasa bazında farklı animasyon seçimi.

5. Ödül ve Nadirlik Sistemi​

Beş farklı ödül nadirliği:

• COMMON: Sıradan — Beyaz.
• RARE: Nadir — Açık mavi.
• EPIC: Epik — Mor.
• LEGENDARY: Efsanevi — Turuncu.
• MYTHIC: Mitik — Magenta.

Ödül özellikleri:

• Minecraft eşyalarını ödül olarak tanımlama.
• ItemsAdder özel eşyalarını ödül olarak kullanma.
• Konsol komutuyla ödül verme.
• Büyülü ve özel isimli eşyaların meta bilgilerini saklama.
• Ödül miktarı düzenleme.
• Ödül ekleme ve silme.
• Sayfalı ödül listesi.
• Ödül nadirliği değiştirme.
• Kazanma şansını yüzdelik olarak gösterme.
• Ödül yüzdelerini toplam %100 üzerinden düzenleme.
• Nadirliğe göre görsel efekt uygulama.

6. Fiziksel ve Sanal Anahtar Sistemi​

• Kasa türüne özel fiziksel anahtarlar.
• SQLite destekli sanal anahtar bakiyesi.
• Oyuncuya anahtar verme komutları.
• Anahtar bakiyesi kontrolü.
• ItemsAdder özel anahtar modelleri.
• Anahtar doğrulama sistemi.
• Fiziksel anahtarlar için HMAC-SHA256 imzalama.
• Anahtarlara benzersiz UUID tanımlama.
• Kullanılmış anahtarları kayıt üzerinden yeniden kullanıma kapatma.
• Aynı anda birden fazla kasa açılışına yönelik güvenlik kontrolleri.

7. ItemsAdder ve 3D Kasa Entegrasyonu​

• ItemsAdder mobilyalarını kasa olarak kullanabilme.
• Özel 3D kasa modelleriyle etkileşim.
• ArmorStand tabanlı mobilya desteği.
• ItemsAdder mobilya etkileşim olayları için entegrasyon.
• Mobilyanın farklı yüzeylerinden etkileşimi desteklemeye yönelik düzeltmeler.
• Mobilya ile kasa kimliği eşleştirme.
• ItemsAdder özel anahtar ve ödül modelleri.
• Normal Minecraft kasalarıyla birlikte kullanım.

Not: Gerçek model kapağının açılıp kapandığı 3D animasyonlar henüz geliştirme hedefleri arasındadır.

8. Hologram Sistemi​

• Kasa üzerinde hologram gösterimi.
• Kasa ismi ve ödül sayısı görüntüleme.
• Anahtar gereksinimi bilgisi.
• Kasa bazında hologram açma ve kapatma.
• YAML üzerinden hologram satırları.
• Hologram yükseklik ayarı.
• %crate%, %id%, %rewards% değişkenleri.
• Ayrı hologram plugini zorunluluğu olmadan ArmorStand isim etiketleri üzerinden çalışma.

9. Güvenlik ve Ödül Teslim Sistemi​

• SQLite işlem kayıtları.
• Kasa açma sırasında ödülün önceden belirlenmesi.
• Ödül teslim durumu takibi.
• Sanal anahtar tüketiminde veritabanı işlemleri.
• İmzalı fiziksel anahtar doğrulaması.
• Tekrar kullanım kontrolleri.
• Oyuncu bazında eşzamanlı kasa açılışı engelleme.
• Bekleyen ödüller için teslim komutu.
• Envanteri dolu oyunculara yönelik ödül teslim kuyruğu.
• Sunucu kapanması sırasında belirsiz kalan teslimatları yönetici incelemesine yönlendirme.
• Yönetici anahtar dağıtım kayıtları.

Güvenlik durumu: Bu mekanizmalar geliştirilmiş olmakla birlikte tüm eşzamanlılık, sunucu çökmesi ve veri kurtarma senaryoları bağımsız olarak doğrulanmamıştır. Özellikle fiziksel envanter işlemleriyle SQLite arasında tam atomiklik garantisi bulunmamaktadır.

10. Türkçe ve İngilizce Dil Sistemi​

• tr_TR.yml Türkçe dil dosyası.
• en_US.yml İngilizce dil dosyası.
• İngilizce standart komutlar.
• Yapılandırmadan dil seçimi.
• Oyuncu mesajlarını özelleştirme.
• GUI başlıklarını ve açıklamalarını çevirme altyapısı.
• Hologram metinlerini düzenleme.
• Renk kodlarını destekleyen mesajlar.
• Noktalama işaretli çeviriler için güvenli from / to yapısı.
• Dil dosyası yükleme hatalarında kayıt ve geri dönüş mekanizması.

Dil sistemi aktif olarak geliştirilmektedir; bazı dinamik metinlerin çeviri kapsamı ayrıca test edilmektedir.

11. Komut Sistemi​

Temel komutlar İngilizce standardına geçirilmiştir.

Komut	Açıklama
/crates editor	Kasa yönetim paneli
/crates create <id>	Yeni kasa oluşturma
/crates open <id>	Kasa açma
/crates preview <id>	Ödül önizleme
/crates givekey <player> <id> <amount>	Fiziksel anahtar verme
/crates givevirtual <player> <id> <amount>	Sanal anahtar verme
/crates bindfurniture <id>	Mobilyayı kasaya bağlama
/crates hologram <id> on/off	Hologram kontrolü
/crates claim	Bekleyen ödülleri teslim alma
/crates reload	Yapılandırmayı yeniden yükleme

Komutlar yetkilere ve ilgili kasa ayarlarına göre çalışır.

---

Geliştirme Yol Haritası​

Planlanan sonraki özellikler:

• Gerçek 3D kasa kapağı animasyonları.
• Gelişmiş Pity (garanti ödül) sistemi.
• Toplu kasa açma.
• Animasyon atlama seçenekleri.
• Kasa açılış istatistikleri.
• Ayrıntılı oyuncu geçmişi.
• Ödül stok ve limitleri.
• Vault ekonomi entegrasyonu.
• PlaceholderAPI entegrasyonu.
• MySQL/MariaDB desteği.
• Özel kasa etkinlikleri.
• Ödül koleksiyon sistemi.
• Geliştiriciler için genişletilmiş API.
• Farklı Minecraft sürümlerinde kapsamlı otomatik testler.

---

Proje Durumu​

AgiraCrates, aktif olarak geliştirilen özel bir Minecraft kasa eklentisidir.

Geliştirme sürecinde Paper 1.21.11 üzerinde kasa oluşturma, ödül dağıtma, animasyonlar, ItemsAdder mobilya etkileşimleri ve hologramlar gibi temel özellikler oyun içerisinde test edilmiştir.

Son güvenlik ve dil altyapısı güncellemelerinin tamamı ise henüz kapsamlı üretim testlerinden geçirilmemiştir.

Hedefimiz; performanslı, esnek, görsel açıdan gelişmiş ve sunucu yöneticilerinin kolayca kullanabileceği profesyonel bir kasa sistemi ortaya çıkarmaktır.

AgiraCrates — Kasadan daha fazlası.

GİF KALİTELERİ İÇİN KUSURA BAKMAYIN GELİŞTİRME İŞİ BİTİNCE DAHA KAPSAMLI VE KALİTELİ BİR VİDEOYU YOUTUBE'DA PAYLAŞACAĞIM..

başarılı bir eklenti olmuş, daha çok fonksiyon ve özellik eklenebilir , daha çok geliştirilebilir

 

[kursattbektas]

Claude'a bunu yaptırmaktansa SpecializedCrates leak indirir içindeki ratı Claude'a temizletir kullanırım daha iyi.

Öncelikle yorumun için teşekkür ederim Claude'a bunu yaptırmadım iskelet ve temel basamak için ChatGPT kullandım özellikleri yine GPT'ye ekletip hata oluşturabilecek kısımları kendim düzenledim. Ve bu sadece başlangıç içindi daha yapıcağım çok şey olucak hatamda olacak illaki ama herhangi bir satılık uygulamayı leak indirip rat temizletmek ne kadar mantıklı bilemem.

 

[kursattbektas]

başarılı bir eklenti olmuş, daha çok fonksiyon ve özellik eklenebilir , daha çok geliştirilebilir

Değerli yorumunuz için teşekkür ederim elimden geldiğince sunucuyu yormayan fonksiyon ve kullanım kolaylıklarını ekleyip dil destekleri ile global bi çalışma yapmayı düşünüyorum.