XiaVaults

🎒 XiaVaults — Kurumsal Oyuncu Kasaları & Güvenli Depolama Sistemi

📌 Genel Bakış (Overview)

XiaVaults, modern Minecraft sunucuları için geliştirilmiş; eşya güvenliğini, çoklu sunucu senkronizasyonunu ve performansı odağına alan kurumsal sanal kasa (Player Vaults / Backpack) sistemidir.

Oyunculara yetkilerine göre 1'den 54'e kadar özel sanal kasa hakkı tanır. Gelişmiş Redis Dağıtık Kilit (Distributed Locking) mimarisi sayesinde, BungeeCord/Velocity ağlarında aynı kasanın aynı anda birden fazla sunucuda açılarak eşyaların kopyalanmasını (duplication exploit) %100 kesinlikle engeller.

✨ Öne Çıkan Özellikler

• 🎒 Çok Sayfalı Sanal Kasalar (/pv <no>):
  • Her oyuncu için 1 ile 54 arasında kasa desteği.
  • Kasa hakları izin düğümleriyle (xiavaults.vault.<sayı>) esnekçe ayarlanabilir (Örn: VIP'lere 5 kasa, MVP'lere 15 kasa).
• 🔒 Sunucular Arası Anti-Dupe Kilit Ağı (Redis Lock):
  • Bir oyuncu kasasını açtığında kasa ağ genelinde kilitlenir; diğer sunucularda aynı anda açılamaz ve dupe girişimleri bloke edilir.
• 💾 %100 NBT Koruyucu Base64 İkili Depolama:
  • Özel büyüler, lore satırları, zırh süslemeleri (armor trims) ve PersistentDataContainer (PDC) etiketleri hiçbir veri kaybı olmadan kaydedilir.
• 🚫 Kutu İçi Kutu (Shulker Box) Engellemesi:
  • Kasa içine Shulker kutusu konulmasını engelleyerek sunucu çökmeleri ve aşırı veri yüklemelerinin önüne geçer (blacklist.materials).
• 🎨 İnteraktif Kasa Seçim Menüsü (GUI):
  • /pv komutu tek başına yazıldığında oyuncunun kilitli ve açık olan tüm kasalarını şık bir arayüzde gösterir.
• 🛠️ Canlı Yönetici Denetimi (Admin Spy & Edit):
  • Yetkililer çevrimiçi veya çevrimdışı herhangi bir oyuncunun kasasını inceleyebilir, içindeki eşyaları alabilir ya da silebilir (/pv <oyuncu> <kasa>).
• ⚡ Çift Veritabanı Motoru:
  • SQLite (yerel dosya) ve MySQL/MariaDB (uzak küme) bağlantı havuzu desteği.
• 🧩 Geniş PlaceholderAPI Desteği:
  • Skor tablosu ve menüler için hazır yer tutucular.

💻 Komutlar ve Yetkiler

🔑 İzin Düğümleri (Permissions):

• xiavaults.use — Temel kasa sistemini kullanabilme izni.
• xiavaults.vault.<1-54> — Oyuncunun kaçıncı kasaya kadar erişebileceğini belirler (Örn: xiavaults.vault.5).
• xiavaults.admin — Tüm oyuncuların kasalarını denetleme ve düzenleme yetkisi.
• xiavaults.bypass — Kara listedeki eşyaları (Shulker Box vb.) kasaya koyabilme izni.

🧩 PlaceholderAPI Desteği

⚙️ Yapılandırma (config.yml)

settings:
  language: tr
  default-rows: 6
  default-vaults: 1
  max-vaults: 54
  auto-save-interval-minutes: 5

# Kasalara konulması yasaklanan eşyalar
blacklist:
  enabled: true
  materials:
    - SHULKER_BOX
    - WHITE_SHULKER_BOX
    - BLACK_SHULKER_BOX

database:
  type: sqlite # 'sqlite' veya 'mysql'
  sqlite:
    file: vaults.db
  mysql:
    host: localhost
    port: 3306
    database: xia_vaults
    username: root
    password: ''

redis:
  sync: true
  channel: "xia:vaults:sync"

📦 Gereksinimler

• Sunucu Motoru: PaperMC 1.20+ (Paper 26.2+ / Folia uyumlu)
• Java: Java 21 LTS veya Java 25 LTS
• Zorunlu Çekirdek: XiaAPI (Sunucuda kurulu olmalıdır)
• (Opsiyonel): PlaceholderAPI

XiaVaults • Güvenli, Hızlı ve Anti-Dupe Korumalı Kasa Sistemi
Developed with ❤️ by Xia Team
Support: [email protected]