# 🕊️ XiaFlight — Gelişmiş Uçuş, Süreli Uçuş ve Trail Sistemi

--- ## 📌 Genel Bakış (Overview) **XiaFlight**, modern Minecraft sunucuları için tasarlanmış yüksek performanslı, güvenli ve zengin özellikli bir uçuş yönetim motorudur. Klasik sınırsız uçuş modunun yanı sıra **saniye/dakika bazlı süreli uçuş (`/tempfly`)**, **uçuş hız kontrolü (`/flyspeed`)**, **uçarken arkada süzülen partikül izleri (trails)**, **savaş engeli koruması** ve **interaktif GUI kontrol paneli** sunar. Kurumsal **HikariCP MySQL/SQLite** veritabanı altyapısı ve **Redis Pub/Sub** senkronizasyonu sayesinde BungeeCord/Velocity ağlarında oyuncuların uçuş süreleri ve durumları tüm sunucular arasında anlık olarak senkronize edilir. --- ## ✨ Öne Çıkan Özellikler * **🕊️ Sınırsız & Süreli Uçuş (`/tempfly`):** * Oyunculara ödül, VIP ayrılacağı veya etkinlik kazanımı olarak süre bazlı (örn: 15m, 1h, 2d) uçuş bakiyesi tanımlanabilir. * Uçuş süresi sadece oyuncu havada uçarken azalır, yere indiğinde otomatik duraklatılır. * **⚡ Dinamik Uçuş Hızı (`/flyspeed`):** * 1x ile 5x arasında ayarlanabilir uçuş hızı. Yetkilendirilebilir maksimum hız limiti. * **✨ Görsel Partikül İzleri (Trails):** * Oyuncular uçarken arkalarında estetik partikül efektleri bırakır. GUI üzerinden kolayca seçilebilir. * **⚔️ Akıllı Savaş & Güvenli Düşüş Koruması:** * Savaşa giren oyuncunun uçuşu anında iptal edilir (`disable-in-combat: true`). * **Safe-Fall Güvenliği:** Uçuşu savaş veya süre bitimi nedeniyle aniden kapanan oyuncu yere çakılıp ölmez; belirlenen süre boyunca düşüş hasarından korunur. * **🚫 Yasaklı Dünya Kısıtlamaları:** * PvP arenası, zindan veya savaş bölgelerinde (`blacklisted-worlds`) uçuş otomatik engellenir. * **🖥️ Actionbar Canlı HUD:** * Uçuş sırasında oyuncunun ekranında kalan süreyi, hızını ve aktif efektini şık bir gradient ile gösterir. * **🎨 İnteraktif GUI Kontrol Paneli:** * Oyuncuların hız ve partikül ayarlarını yapabileceği modern envanter menüsü. * **💾 Kurumsal Veri Depolama & Redis Senkronizasyonu:** * MySQL ve SQLite çifte desteği. * Çoklu sunucu ağlarında `/tempfly give` komutu verildiğinde Redis üzerinden anlık güncelleme. * **🧩 Geniş PlaceholderAPI Desteği:** * Skor tablosu (Scoreboard) ve tab listesi için hazır yer tutucular. --- ## 💻 Komutlar ve Yetkiler | Komut | Kısayollar | Açıklama | Gerekli Yetki | |---|---|---|---| | `/fly [oyuncu]` | `/flight`, `/ucus` | Uçuş modunu açar veya kapatır. | `xiaflight.use` (Kendi için) / `xiaflight.others` | | `/tempfly` | `/tfly`, `/sureliucus` | Kalan süreli uçuş bakiyesini görüntüler. | `xiaflight.tempfly` | | `/tempfly give ` | — | Oyuncuya süreli uçuş ekler (Örn: `1h30m`). | `xiaflight.admin` | | `/tempfly take ` | — | Oyuncunun uçuş süresinden düşer. | `xiaflight.admin` | | `/tempfly set ` | — | Oyuncunun süresini sabitler. | `xiaflight.admin` | | `/flyspeed <1-5>` | `/fspeed`, `/ucushizi` | Uçuş hızını ayarlar. | `xiaflight.speed` | ### 🔑 Ekstra İzinler (Permissions): * `xiaflight.fly` — Kalıcı (sınırsız) uçuş yetkisi. * `xiaflight.trails` — Partikül efektlerini kullanabilme yetkisi. * `xiaflight.admin` — Tüm yönetim komutlarını kullanma yetkisi. * `xiaflight.bypass` — Savaş engeli ve yasaklı dünya kısıtlamalarını aşma yetkisi. --- ## 🧩 PlaceholderAPI Desteği | Placeholder | Açıklama | Örnek Çıktı | |---|---|---| | `%xiaflight_status%` | Oyuncunun anlık uçuş durumu | `Aktif` / `Pasif` | | `%xiaflight_time%` | Biçimlendirilmiş kalan uçuş süresi | `1s 25d 10sn` veya `Sınırsız` | | `%xiaflight_seconds%` | Kalan sürenin ham saniye değeri | `5110` | | `%xiaflight_speed%` | Mevcut uçuş hızı çarpanı | `1`, `2`, `3` | | `%xiaflight_trail%` | Aktif partikül efektinin adı | `Alev İzi`, `Yıldız Tozu` | --- ## ⚙️ Yapılandırma (`config.yml`) ```yaml settings: language: tr default-speed: 1 max-speed: 5 auto-save-interval-minutes: 5 combat: disable-in-combat: true combat-tag-seconds: 15 safe-fall-seconds: 10 restrictions: blacklisted-worlds: - "pvp_arena" - "war_zone" actionbar-hud: enabled: true show-infinite: false format: "✦ UÇUŞ ✦ Kalan: {time} | Hız: {speed}x" database: type: sqlite # 'sqlite' veya 'mysql' sqlite: file: flight.db mysql: host: localhost port: 3306 database: xia_flight username: root password: '' redis: sync: true channel: "xia:flight:sync" ``` --- ## 📦 Gereksinimler * **Sunucu Motoru:** [PaperMC](https://papermc.io/) 1.20+ (Paper 26.2+ / Folia uyumlu) * **Java:** Java 21 LTS veya Java 25 LTS * **Zorunlu Bağımlılık:** **[XiaAPI](https://hangar.papermc.io/XiaPlugins/XiaAPI)** (Sunucuda kurulu olmalıdır) * **(Opsiyonel):** [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) ---

XiaFlight • Modern Uçuş & Süreli Uçuş Çözümü
Developed with ❤️ by Xia Team
Support: xiaplugins@proton.me

XiaFlight

1.0.0