⚔️ 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:

Full Inventory: Includes armor sets and off-hand items.
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"