🎲 LuckyBlock v1.3-RELEASE

LuckyBlock, Minecraft sunucuları için geleneksel config dosyalarıyla uğraşma devrini kapatan, tamamen oyun içi (In-Game) kullanıcı arayüzü (GUI) üzerinden yönetilebilir gelişmiş ve sömürü (exploit) korumalı bir şans bloğu eklentisidir.

Sunucu sahipleri ve yöneticiler, hiçbir komut yazmadan veya sunucu dosyalarına girmeden doğrudan oyun içinden ödül oranlarını, şans blok materyalini ve gelişmiş animasyon ayarlarını anlık olarak güncelleyebilirler.

🚀 Öne Çıkan Özellikler (Features)

• 🛠 Tamamen Oyun İçi Yönetim (In-Game GUI): /lb komutuyla açılan şık menü sayesinde tüm eklenti ayarlarını ve yeni v1.3 özelliklerini oyun içinden görsel olarak düzenleyin.
• 🔒 Gerçek Yerleştirme Takibi (Anti-Exploit - YENİ): Oyuncuların isim değiştirilmiş sıradan bloklarla veya doğal yapılarla ödül farmlamasını tamamen engeller. Sistem, sadece oyun içinden belirlenen ve yerleştirilen gerçek şans bloklarını takip eder.
• 🎡 Görsel Rulet Animasyonu (Slot-Machine - YENİ): Blok kırıldığında ödüller anında düşmez; konfigüre edilebilir ses ve parçacık efektleriyle süslenmiş, yavaşlayarak duran şık bir GUI menüsü açılır.
• ⚡ Anlık Otomatik Yenileme (Instant Auto-Reload): Menüden "Kaydet" (Örs) butonuna tıkladığınızda veriler otomatik olarak diske yazılır, belleği tazeler ve sunucuyu yormadan kendini anlık reload eder.
• 📊 Dinamik Ödül Oranları Kontrolü: Ödüllerin çıkma şans yüzdelerini Shift+Sağ/Sol Tık mekanikleriyle menüden ayarlayın. Yeni dinamik havuz algoritması sayesinde oranlar toplamı 100'ü geçse bile hiçbir ödül havuz dışı kalmaz.
• 🏆 İstatistik & Liderlik Tablosu (Leaderboard - YENİ): Oyuncuların açtığı şans bloğu sayıları anlık kaydedilir. Menü üzerinden sunucunun en şanslı oyuncuları listelenebilir.
• 💬 Güvenli Sohbet Entegrasyonu: Lucky Block ismini veya eklenti prefixini menüden seçip doğrudan chat'e yazarak güncelleyin. Tüm sohbet girdileri ana sunucu döngüsüne (Sync Thread) taşınarak thread-safe hale getirilmiştir.
• 🎨 Geniş Renk ve HEX Desteği: Hem oyun içi menülerde hem de konsol loglarında göz alıcı modern tasarımlar ve HEX renk kodları tam uyumlulukla çalışır.

📋 Komutlar ve Yetkiler (Commands & Permissions)

• /lb veya /luckyblock - Ana yönetim panelini, istatistikleri ve ödül ayarlarını açar.
  • Yetki: luckyblock.admin

📂 Veri Yapısı (Data Structure)

Eklenti, veritabanı yükü oluşturmamak ve yüksek TPS değerlerini korumak için hafif ve hızlı I/O işlemlerine sahip dosyalar kullanır:

• config.yml: Oyun içi menüden değiştirilen prefix, materyal ve oranları saklar.
• lucky_locations.txt: Yerleştirilen gerçek şans bloklarının koordinatlarını dunya;x;y;z formatında saklar[cite: 1].
• stats.txt: Oyuncuların kırdığı toplam blok sayılarını UUID:Miktar formatında güvenle tutar[cite: 1].

📦 Kurulum (Installation)

1. İndirdiğiniz luckyblock-1.3-release.jar dosyasını sunucunuzun plugins/ klasörüne atın.
2. Sunucunuzu başlatın.
3. /lb yazarak yönetim arayüzüne giriş yapın ve özelleştirmeye başlayın!

🛠 Desteklenen Platformlar (Supported Platforms)

Eklenti, en güncel Minecraft mimarisine uygun olarak aşağıdaki platformlarda sıfır hata ve maksimum performansla test edilmiştir:

• Purpur / Paper / Spigot (Minecraft 1.21.8 ve üzeri kararlı sürümler)[cite: 1]