![\"Version\"](\"https:\/\/img.shields.io\/badge\/Version-1.1.0-blue.svg?style=for-the-badge\")
\n
![\"Platform\"](\"https:\/\/img.shields.io\/badge\/Platform-Paper%20%2F%20Spigot-orange.svg?style=for-the-badge\")
\n
![\"Java\"](\"https:\/\/img.shields.io\/badge\/Java-21-red.svg?style=for-the-badge\")
\n
![\"Author\"](\"https:\/\/img.shields.io\/badge\/Author-Imperior%20Development-purple.svg?style=for-the-badge\")
\n<\/p>\n# \u2694\ufe0f HubPvP<\/p>\n
\n
\n
\n
\n \n<\/p>\n
—<\/p>\n
## \ud83c\udf1f Overview
\n**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.<\/p>\n
## \ud83d\ude80 Features
\n– \u26a1 **Extreme Optimization:** Engineered for minimal resource consumption.
\n– \ud83d\udee1\ufe0f **Inventory Protection:** Securely saves and restores original inventories upon entering\/exiting PvP.
\n– \ud83e\uddea **Effect Management:** Automatically clears active potion effects when combat mode is activated.
\n– \ud83d\udd0a **Auditory Feedback:** Configurable high-quality sounds for activation and countdowns.
\n– \ud83c\udfa8 **Modern Color Support:** Fully compatible with MiniMessage and advanced gradients.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration & Setup<\/p>\n
All settings can be found in `config.yml`. Here is how you can customize the main components:<\/p>\n
### \ud83d\udde1\ufe0f Sword Settings ### \u23f2\ufe0f Timers & Mechanics —<\/p>\n ## \ud83d\udee0\ufe0f Advanced Features<\/p>\n ### \ud83d\udd04 State Restoration ### \ud83d\udc80 Death Handling ### \ud83d\udce1 Developer Note —<\/p>\n ## \ud83c\udfd7\ufe0f Requirements —<\/p>\n \n Developed with \u2764\ufe0f by Imperior Development<\/b> A plugin designed to enhance your server’s functionality, allowing for PvP in the lobby\/hub<\/p>\n","protected":false},"featured_media":82563,"template":"","meta":{"_minecraft_slug":"hubpvp","_minecraft_project_id":"skknFAZy","_minecraft_author":"alexclient","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":20,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hubpvp.zip","_minecraft_size_bytes":330051,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:55:40.076805Z","_minecraft_date_created":"2026-05-05T21:00:29.442207Z","_minecraft_date_modified":"2026-04-26T17:58:09.750496Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hubpvp","_minecraft_icon_attachment_id":82563,"_minecraft_imported_at":"2026-06-04T17:40:08+00:00","_minecraft_import_hash":"f6ad9d3471abf24ca29faf13a6ea24f4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,88,89,866,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82562","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-equipment","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n“`yaml
\nsword:
\n material: DIAMOND_SWORD
\n display-name: “
\n lore:
\n – “&7Hold this sword to”
\n – “&7activate PvP mode!”
\n slot: 4 # Central hotbar slot
\n“`<\/p>\n
\nSet the required time a player must hold the sword to enter or exit combat.
\n– **`hold-time`**: Seconds required holding the sword to activate PvP.
\n– **`deactivate-time`**: Seconds required without the sword to deactivate PvP.<\/p>\n
\nThe plugin utilizes a **concurrent mapping system** to handle:
\n1. **Full Inventory:** Includes armor sets and off-hand items.
\n2. **Flight Status:** If a player has flight enabled (`\/fly`), the plugin disables it during PvP and restores it automatically upon exit or death.<\/p>\n
\nWhen a player dies in PvP mode:
\n– Item drops are automatically cleared to prevent lobby lag.
\n– A professional particle effect is spawned at the death location.
\n– The killer receives an instant full health restoration (configurable).<\/p>\n
\nBuilt 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.<\/p>\n
\n– **Server:** PaperMC 1.21 or higher (Recommended).
\n– **Java:** Version 21.<\/p>\n
\n “Excellence in Minecraft Development”<\/i><\/p>\n","protected":false},"excerpt":{"rendered":"