# 🎒 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 `):** * Her oyuncu için 1 ile 54 arasında kasa desteği. * Kasa hakları izin düğümleriyle (`xiavaults.vault.`) 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 `). * **⚡ Ç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 | Komut | Kısayollar | Açıklama | Gerekli Yetki | |---|---|---|---| | `/pv` | `/vault`, `/kasa`, `/playervaults` | Kasa seçim menüsünü açar. | `xiavaults.use` | | `/pv ` | `/vault ` | Belirtilen numaralı özel kasayı doğrudan açar. | `xiavaults.use` & `xiavaults.vault.` | | `/pv ` | — | Başka bir oyuncunun kasasını görüntüler ve yönetir. | `xiavaults.admin` | ### 🔑 İ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 | Placeholder | Açıklama | Örnek Çıktı | |---|---|---| | `%xiavaults_unlocked%` | Oyuncunun erişebildiği aktif kasa sayısı | `5` | | `%xiavaults_max%` | Sunucudaki maksimum kasa limiti | `54` | | `%xiavaults_items_%` | Belirtilen kasadaki toplam eşya adedi | `24` | | `%xiavaults_name_%` | Belirtilen kasanın başlığı | `Kasa #1` | --- ## ⚙️ Yapılandırma (`config.yml`) ```yaml 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](https://papermc.io/) 1.20+ (Paper 26.2+ / Folia uyumlu) * **Java:** Java 21 LTS veya Java 25 LTS * **Zorunlu Çekirdek:** **[XiaAPI](https://hangar.papermc.io/XiaPlugins/XiaAPI)** (Sunucuda kurulu olmalıdır) * **(Opsiyonel):** [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) ---

XiaVaults • Güvenli, Hızlı ve Anti-Dupe Korumalı Kasa Sistemi
Developed with ❤️ by Xia Team
Support: xiaplugins@proton.me

XiaVaults

1.0.0