KerioFly-Folia

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

* Developer-First API: Fully compatible with Folia's regionalized multithreading. It utilizes regional schedulers to ensure thread safety and peak performance even under heavy load. * Developer-First API: Players can earn, buy, or be rewarded with flight seconds. Flight is automatically disabled when the timer hits zero. * Developer-First API: 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. * Developer-First API: Features a dedicated "Points" system that players can use to trade, purchase flight time, or interact with other economy-based features. * Developer-First API: Includes an optional "Pause on AFK" feature to prevent players from wasting their precious flight time while standing still. * Developer-First API: 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

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

Example: Activating a Guild Flight Boost

```java // 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. Setup: Folia, Paper, or Purpur (1.21+). 2. Setup: Version Setup or higher. 3. Setup: * Place the JAR in your `plugins` folder. * Restart your server to generate the configuration. * (Optional) Install Setup and %%MD1%% 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.