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"> </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

- ⚡ Modern Color Support: Engineered for minimal resource consumption. - 🛡️ Modern Color Support: Securely saves and restores original inventories upon entering/exiting PvP. - 🧪 Modern Color Support: Automatically clears active potion effects when combat mode is activated. - 🔊 Modern Color Support: 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. - `deactivate-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 Flight Status: to handle: 1. Flight Status: 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 ACF (Aikar's Command Framework) and ACF (Aikar's Command Framework) to ensure full compatibility with the latest Paper versions (1.21.x) and efficient command handling.

---

🏗️ Requirements

- Java: 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>