⚔️ HubPvP

---

🌟 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

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.

---

Developed with ❤️ by Imperior Development
"Excellence in Minecraft Development"