🕊️ KerioFly-Folia

The High-Performance Flight Management Solution for Modern Minecraft Servers.

KerioFly is a specialized flight management plugin built from the ground up for Folia and Paper servers. Designed for high-player-count environments, it offers a robust "Flight Time" system, an integrated point economy, and a powerful API specifically crafted for third-party integrations like Guilds or Battle Passes.

---

✨ Key Features

• Native Folia Support: Fully compatible with Folia's regionalized multithreading. It utilizes regional schedulers to ensure thread safety and peak performance even under heavy load.
• Time-Based Flight Economy: Players can earn, buy, or be rewarded with flight seconds. Flight is automatically disabled when the timer hits zero.
• Temporary Unlimited Flight (Exclusive!): Perfect for Guild Perks or Server Events. Grant players "Infinite Flight" for a specific duration (e.g., 24 hours) without affecting their stored flight time or permanent permissions.
• Integrated Points System: Features a dedicated "Points" system that players can use to trade, purchase flight time, or interact with other economy-based features.
• Smart AFK Protection: Includes an optional "Pause on AFK" feature to prevent players from wasting their precious flight time while standing still.
• Hex Color Support: Fully supports modern HEX color codes (e.g., &#RRGGBB) in all messages and displays.
• Developer-First API: A clean, documented API designed for seamless integration with other plugins.

---

🛠 Developer API (Quick Start)

KerioFly provides a comprehensive API, making it the perfect companion for your custom server ecosystem.

Maven Dependency

<dependency>
    <groupId>me.kerio</groupId>
    <artifactId>KerioFly</artifactId>
    <version>1.0.0</version>
    <scope>provided</scope>
</dependency>

Example: Activating a Guild Flight Boost

// Grant 24 hours (86400 seconds) of unlimited flight to a guild member
// This will not consume their personal flight time bank.
KerioFly.getAPI().giveTemporaryUnlimited(playerUUID, 86400L);

---

📊 PlaceholderAPI Support

Integrate KerioFly data into your Scoreboards, Tablists, or Menus:

• %keriofly_time%: Formatted remaining flight time.
• %keriofly_points%: Current player point balance.

---

📥 Installation & Requirements

1. Software: Folia, Paper, or Purpur (1.21+).
2. Java: Version 21 or higher.
3. Setup:
   • Place the JAR in your plugins folder.
   • Restart your server to generate the configuration.
   • (Optional) Install PlaceholderAPI and Vault for the best experience.

---

📜 Commands & Permissions

• /f - Toggle flight mode.
• /f view - Check your remaining flight time and flight points.
• keriofly.unlimited - Permission for permanent, cost-free infinite flight.

---

KerioFly — Empowering your players with the freedom of the skies, optimized for the next generation of Minecraft servers.