XiaFlight

🕊️ 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

🔑 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

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

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: "<gradient:#00f2fe:#4facfe><b>✦ UÇUŞ ✦</b></gradient> <gray>Kalan:</gray> <yellow>{time}</yellow> <dark_gray>|</dark_gray> <gray>Hız:</gray> <aqua>{speed}x</aqua>"

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 1.20+ (Paper 26.2+ / Folia uyumlu)
• Java: Java 21 LTS veya Java 25 LTS
• Zorunlu Bağımlılık: XiaAPI (Sunucuda kurulu olmalıdır)
• (Opsiyonel): PlaceholderAPI

XiaFlight • Modern Uçuş & Süreli Uçuş Çözümü
Developed with ❤️ by Xia Team
Support: [email protected]