ZenFights

# ZenFights 2.0.7 (https://img.shields.io/badge/Loaders-Bukkit%20%7C%20Spigot%20%7C%20Paper%20%7C%20Purpur-blue)](#) (https://img.shields.io/badge/MC-1.21.x%20–%2026.1.x-brightgreen)](#) (https://img.shields.io/badge/Java-21%20%7C%2025-orange)](#) **ZenFights** is a high-performance, competitive duel engine built exclusively for the every ecosystem including Paper, Spigot, Bukkit and Purpur. It transforms standard PvP into a highly isolated, professional matchmaking experience, supporting all modern server versions. Version 2.0.7 introduces network-level combat isolation, dynamic Elo-style "Zen" ratings, a fully integrated AI Practice Bot, and an active Discord gateway bridge. (https://cdn.modrinth.com/data/cached_images/05fe664c676a12a0c6ee7a86b31d81be49b09a5c.png)](https://discord.gg/ReqqvMpuHh) (https://zenstudios.xo.je) ## 🌟 Key Features * **Universal Version Support:** Fully optimized for seamless performance across modern PaperMC releases (1.20.x – 1.21.x). * **Network-Level Arena Isolation:** When a duel begins, bystanders vanish. Fighters are network-isolated, preventing third-party interference, stray projectiles, and visual clutter. * **Smart Rollback Sandbox:** Explosions from end crystals/beds and broken blocks are visually hidden from the rest of the server and instantly rolled back when the match concludes. * **AI Practice Bot (Zen Master):** Train your pacing offline. The practice bot features an action-bar virtual health pool (2000 HP), automatic boundary containment, and mimics your selected kit. * **Advanced Spectator Mode:** Server members can spectate live matches using a dedicated `/fight spec` routing engine that bypasses network invisibility while safely locking their commands. * **Elo "Zen" Rating System:** A mathematical ranking system. Players start at `3000` Zen, gaining or losing points dynamically based on the skill gap of their opponent. * **Discord Integration:** A built-in JDA Discord Bot that syncs your server's live match data, offering `/zfbot-top` and `/zfbot-stats` slash commands straight from your Discord server. * **High-Precision Kit Serialization:** Admins can save their entire current state—**Inventory, Armor, and Offhand**—as custom, reusable kits directly from the game. --- ## 🚀 Getting Started ### Installation 1. Download the latest `ZenFights-2.0.x.jar` file. 2. Ensure you have **PlaceholderAPI** installed on your server. 3. Place ZenFights into your server's `plugins/` folder. 4. Restart your server to generate the default `config.yml`. ### Commands & Permissions #### Player Commands | Command | Description | Permission | | :--- | :--- | :--- | | `/fight <player>` | Opens the Kit Selection GUI to challenge a player. | `zenfights.fight` | | `/fight accept <player>` | Accept an incoming duel request. | `zenfights.fight` | | `/fight practice <kit>` | Start an isolated combat simulation against the AI. | `zenfights.fight` | | `/fight practice exit` | Forcibly exit your active simulation early. | `zenfights.fight` | | `/fight spec <player>` | Spectate an active duel in Gamemode 3. | `zenfights.command.spectate` | | `/fight spec leave` | Safely disconnect from the spectator perspective. | `zenfights.command.spectate` | #### Admin Commands | Command | Description | Permission | | :--- | :--- | :--- | | `/zf savekit <name>` | Saves your current inventory layout as a global kit. | `zenfights.admin` | | `/zf deletekit <name>` | Permanently deletes a kit profile. | `zenfights.admin` | | `/zf listkits` | View all active kit templates loaded in memory. | `zenfights.admin` | | `/zf reload` | Reloads the configuration and memory state safely. | `zenfights.admin` | | `/zf loadkit <name>` | Manually equip a saved server kit profile. | `zenfights.base` | *(Note: Give staff members the `zenfights.spectate.bypasscommands` permission to allow them to execute other server commands while locked in spectator mode).* --- ## 📊 PlaceholderAPI Integration ZenFights comes with a built-in expansion. You do **not** need to download anything from the eCloud. Use these anywhere (Scoreboards, TAB, Holograms, Chat): | Placeholder | Output / Description | | :--- | :--- | | `%zenfights_zen%` | Displays the player's current Elo/Zen score (Default: 3000). | | `%zenfights_status%` | Returns `§bIn Fight` or `§7Idle` based on combat state. | | `%zenfights_wins%` | Total number of recorded duel victories. | | `%zenfights_losses%` | Total number of recorded duel defeats. | | `%zenfights_deaths%` | Alias for losses. | | `%zenfights_matches_played%` | The combined total of all historical matches logged. | --- ## ⚙️ Default Configuration (`config.yml`) The configuration file handles your physical arena parameters, reward hooks, and database tracking. ```yaml # ============================================================================== # ZENFIGHTS CONFIGURATION # ========================