HubPvP

# ⚔️ HubPvP <p align="center"> <img src="https://img.shields.io/badge/Version-1.1.0-blue.svg?style=for-the-badge" alt="Version"> <img src="https://img.shields.io/badge/Platform-Paper%20%2F%20Spigot-orange.svg?style=for-the-badge" alt="Platform"> <img src="https://img.shields.io/badge/Java-21-red.svg?style=for-the-badge" alt="Java"> <img src="https://img.shields.io/badge/Author-Imperior%20Development-purple.svg?style=for-the-badge" alt="Author"> <img src="https://img.shields.io/badge/Author-SecurityX-red.svg?style=for-the-badge" alt="Author" href="https://securityx.sbs"> </p> --- ## 🌟 Overview **HubPvP** is a professional and highly optimized solution designed to manage PvP combat within lobbies or hubs. It allows players to engage in controlled combat using a special sword, ensuring a seamless and error-free experience for your community. ## 🚀 Features - ⚡ **Extreme Optimization:** Engineered for minimal resource consumption. - 🛡️ **Inventory Protection:** Securely saves and restores original inventories upon entering/exiting PvP. - 🧪 **Effect Management:** Automatically clears active potion effects when combat mode is activated. - 🔊 **Auditory Feedback:** Configurable high-quality sounds for activation and countdowns. - 🎨 **Modern Color Support:** Fully compatible with MiniMessage and advanced gradients. --- ## ⚙️ Configuration & Setup All settings can be found in `config.yml`. Here is how you can customize the main components: ### 🗡️ Sword Settings ```yaml sword: material: DIAMOND_SWORD display-name: "<gradient:#00fbff:#0072ff>&lPVP SWORD</gradient>" lore: - "&7Hold this sword to" - "&7activate PvP mode!" slot: 4 # Central hotbar slot ``` ### ⏲️ Timers & Mechanics Set the required time a player must hold the sword to enter or exit combat. - **`hold-time`**: Seconds required holding the sword to activate PvP. - **`deactivate-time`**: Seconds required without the sword to deactivate PvP. --- ## 🛠️ Advanced Features ### 🔄 State Restoration The plugin utilizes a **concurrent mapping system** to handle: 1. **Full Inventory:** Includes armor sets and off-hand items. 2. **Flight Status:** If a player has flight enabled (`/fly`), the plugin disables it during PvP and restores it automatically upon exit or death. ### 💀 Death Handling When a player dies in PvP mode: - Item drops are automatically cleared to prevent lobby lag. - A professional particle effect is spawned at the death location. - The killer receives an instant full health restoration (configurable). ### 📡 Developer Note Built using the **Adventure API** and **ACF (Aikar's Command Framework)** to ensure full compatibility with the latest Paper versions (1.21.x) and efficient command handling. --- ## 🏗️ Requirements - **Server:** PaperMC 1.21 or higher (Recommended). - **Java:** Version 21. --- <p align="center"> <b>Developed with ❤️ by Imperior Development</b><br> <i>"Excellence in Minecraft Development"</i> </p>