# \u2694\ufe0f Hub Combat
\n### A simple yet *sexy* plugin to spice up your lobby with weapons and PvP!<\/p>\n
—<\/p>\n
## \ud83d\udca1 Why **Hub Combat**?<\/p>\n
\u2705 **Easy to use**
\n\u2705 **Per group (permission based) inventory given**
\n\u2705 **Any item with any slot, item flag or enchantment can be used!**
\n\u2705 **Free & open source**
\n\u2705 **Optimized for performance**
\n\u2705 **Packed with features**<\/p>\n
\ud83d\udcac It’s the **first hub PvP plugin** with native PlaceholderAPI support!
\n\ud83d\udca1 Got ideas? Suggest them on **Discord** or **GitHub**, and we might just add them in the next release!<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \ud83d\udd27 Fully customizable **item name & lore** using **MiniMessage** and **PlaceholderAPI**.
\n– \ud83c\udff7\ufe0f Built-in **placeholders**: time left, kills, deaths, hits.
\n– \ud83d\ude80 Lightweight and performance-focused.<\/p>\n
—<\/p>\n
## \ud83d\udd10 Commands & Placeholders<\/p>\n
– `\/hubcombat reload` \u2013 Reload config and player stats. Requires `hubcombat.admin` permission.<\/p>\n
### \ud83d\udccc Placeholders:
\n– `%hubcombat_kills%`
\n– `%hubcombat_deaths%`
\n– `%hubcombat_hits%`
\n– `%hubcombat_kdr%`
\n– `%hubcombat_time_left%`
\n– `%hubcombat_is_in_combat%` (returns “true” or “false”)<\/p>\n
—<\/p>\n
## \u2699\ufe0f Installation & Usage<\/p>\n
1. \ud83d\udce5 Drop the `.jar` into your `\/plugins` folder.
\n2. \ud83d\udd01 Restart the server.
\n3. \u2705 H2 database is used by default \u2014 **no setup required**.
\n – You can switch to **MySQL** for multi-lobby support.
\n4. \ud83d\udde3\ufe0f Customize all messages via `lang.yml`.<\/p>\n
\ud83d\udee1\ufe0f On join, players receive the weapon. PvP is enabled **only** if the weapon is equipped for the configured amount of time.
\n\ud83d\udc4a Entities or players without the weapon **can’t deal damage** \u2014 total control over hub PvP!<\/p>\n
—<\/p>\n
## Config:<\/p>\n
“`
\n# Available drivers: h2, mysql
\n# If you are using h2, you don’t need to specify the host, port, db-name,
\n# username and password due to h2 is local database.
\ndatabase:
\n driver: h2
\n host: 101.101.101.101
\n port: 3306
\n db-name: hubcombat
\n username: userNaMeForHubCombat
\n password: passw0rD<\/p>\n
timing:
\n give-weapon: 5
\n remove-weapon: 5<\/p>\n
# All the items from plugin vip: ## \ud83d\udee3\ufe0f Roadmap<\/p>\n – \ud83d\udde1\ufe0f Add **multiple weapons** via permissions. **-> ADDED**  Simple but sexy plugin for enhance your lobby adding weapons!<\/p>\n","protected":false},"featured_media":82555,"template":"","meta":{"_minecraft_slug":"hubcombat","_minecraft_project_id":"oNVUQ7af","_minecraft_author":"LinsaFTW","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":585,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hubcombat.zip","_minecraft_size_bytes":559120,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T10:22:54.190641Z","_minecraft_date_created":"2025-04-23T03:53:35.171981Z","_minecraft_date_modified":"2025-12-10T14:36:27.130270Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hubcombat","_minecraft_icon_attachment_id":82555,"_minecraft_imported_at":"2026-06-04T17:39:46+00:00","_minecraft_import_hash":"0f5fd8703f5f6a4c8d4ec263e8b0a4e6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82554","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-paper","mod_category-utility","mod_loader-paper","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# U can add as many loadouts as u want! Also, u can add as many items
\n# as u want in the loadouts, just copy and paste the “template” for items
\nloadouts:
\n default:
\n permission: hubcombat.loadout.default
\n items:
\n – slot: 4
\n material: DIAMOND_SWORD
\n name: “
\n lore:
\n – “
\n enchantments:
\n DAMAGE_ALL: 3
\n DURABILITY: 2
\n flags:
\n – HIDE_ENCHANTS
\n – HIDE_ATTRIBUTES<\/p>\n
\n permission: hubcombat.loadout.vip
\n items:
\n – slot: 4
\n material: NETHERITE_SWORD
\n name: “
\n lore:
\n – “
\n enchantments:
\n DAMAGE_ALL: 5
\n KNOCKBACK: 2
\n“`<\/p>\n
\n– \ud83d\udee1\ufe0f Add **multiple armors** via permissions. **-> ADDED**
\n– \ud83e\udde9 More placeholders \u2014 suggest yours!<\/p>\n
\n# Tect.host<\/p>\n","protected":false},"excerpt":{"rendered":"