Hrda-KnockbackFFA

# ⚔️ HrdaKnockbackFFA A high-performance, **Multi-Arena KnockbackFFA** plugin designed for competitive servers. Experience seamless gameplay with dynamic boundaries, custom void levels, automatic map rotation, and instant rewards. Perfect for both dedicated minigame servers and survival/lobby setups! ## Need Hosting? Use PROMO CODE! !(https://cdn.modrinth.com/data/cached_images/8443e8369d1512f5db8461bc84c88434baaff156_0.webp)(https://www.neyhost.com/?ref=HRDA) --- ## 🚀 Features * **🔄 Auto Map Rotation**: Keep the gameplay fresh! Maps cycle automatically, seamlessly teleporting active players to the new arena. * **🎒 Inventory Protection**: Completely safe for Survival or Lobby servers! Players' original inventories and armor are perfectly saved upon joining and fully restored when they leave. * **🏟️ Multi-Arena Support**: Create and manage multiple maps on a single server instance. * **🌌 Dynamic Void System**: Set a custom Y-level for death for each map individually. * **🧱 Smart Anti-Grief Barriers**: Define arena boundaries (pos1/pos2) where players can build, preventing block clutter outside the battlefield. * **🏹 Classic Kit**: Players receive a Knockback Stick, Punch Bow (with Unbreaking), Ender Pearls, and infinite Sandstone. * **📊 Live Scoreboard**: Real-time stats tracking kills, online players, and map rotation timer with **zero flickering**. * **💎 Kill Rewards**: Get an extra Ender Pearl, killstreaks with particle effects, and specialized sound effects for every successful void kill. * **⚡ Optimized Performance**: Lightweight code with asynchronous tasks to ensure 20 TPS even during heavy combat. --- ## 🛠️ Commands & Permissions <details> <summary>Click Here</summary> ### Player Commands | Command | Description | | :--- | :--- | | `/kbffa join` | Join the currently active arena | | `/kbffa leave` | Safely return to the lobby and restore your items | | `/kbffa savekit` | Saves your custom kit layout (including off-hand) | | `/kbffa top` | View the top 5 players based on total kills | ### Admin Commands **(`kbffa.admin`)** | Command | Description | | :--- | :--- | | `/kbffa setlobby` | Set the global lobby location | | `/kbffa setspawn <map>` | Set the spawn point for a specific map | | `/kbffa pos1` / `pos2` | Mark the corners for the buildable region | | `/kbffa setarena <map>` | Save the marked region to a map | | `/kbffa setvoid <map>` | Set the death height to your current Y-level | | `/kbffa sign` | Transform the sign you are looking at into a universal join sign | --- </details> ## 🏷️ Placeholders (PlaceholderAPI) This plugin officially supports **PlaceholderAPI**. You can use the following placeholders in your custom scoreboards, tablists, or chat formats: * **`%kbffa_kills%`** - Displays the player's total kills. * **`%kbffa_deaths%`** - Displays the player's total deaths. * **`%kbffa_kd%`** - Displays the player's Kill/Death ratio. * **`%kbffa_streak%`** - Displays the player's current killstreak. --- ## 🗺️ Arena Setup Guide <details> <summary>Click Here</summary> Setting up a new map is easy! Follow these steps in order to ensure everything works perfectly. You can set up as many maps as you want – the plugin will automatically rotate between them! ### 1. Set Arena Spawn Go to the location where you want players to appear when they join or respawn. * **Command:** `/kbffa setspawn <map_name>` * **Note:** This command also initializes the map in the configuration. ### 2. Define Barriers The plugin uses a region system to prevent players from building infinite bridges away from your island. 1. Go to the **lowest bottom-left corner** of your arena and type: `/kbffa pos1` 2. Go to the **highest top-right corner** of your arena and type: `/kbffa pos2` 3. Link these points to your map: `/kbffa setarena <map_name>` * **Result:** Players can only place blocks inside this "invisible box". ### 3. Configure Void Level You don't have to rely on Y=0 anymore. You can set the death height specifically for each map. * **Command:** `/kbffa setvoid <map_name>` * **How to:** Fly down to the level where you want players to "die" (e.g., 10 blocks below your island) and run the command. ### 4. Global Lobby Don't forget to set a place where players return after typing `/kbffa leave`. * **Command:** `/kbffa setlobby` ### 5. Restart Restart your server or reload all the plugins. ### 6. Join Sign (Optional) Look at any sign and type `/kbffa sign`. It will turn into a universal join sign that automatically sends players to the currently active map! --- ### 📖 Setup Example 1. `/kbffa setspawn SkyIsland` 2. `/kbffa pos1` (at the bottom corner) 3. `/kbffa pos2` (at the top opposite corner) 4. `/kbffa setarena SkyIsland` 5. `/kbffa setvoid SkyIsland` (standing at Y: 120) 6. **Done!** Your map is ready and added to the rotation. </details> --- !(https://bstats.org/signatures/bukkit/HrdaKBFFA.svg) --- ## ⚙️ Configuration The plugin generates a `config.yml` w