HubCombat

# ⚔️ Hub Combat ### A simple yet *sexy* plugin to spice up your lobby with weapons and PvP! --- ## 💡 Why **Hub Combat**? ✅ **Easy to use** ✅ **Per group (permission based) inventory given** ✅ **Any item with any slot, item flag or enchantment can be used!** ✅ **Free & open source** ✅ **Optimized for performance** ✅ **Packed with features** 💬 It's the **first hub PvP plugin** with native PlaceholderAPI support! 💡 Got ideas? Suggest them on **(https://discord.smartshub.dev/)** or **GitHub**, and we might just add them in the next release! --- ## ✨ Features - 🔧 Fully customizable **item name & lore** using **MiniMessage** and **PlaceholderAPI**. - 🏷️ Built-in **placeholders**: time left, kills, deaths, hits. - 🚀 Lightweight and performance-focused. --- ## 🔐 Commands & Placeholders - `/hubcombat reload` – Reload config and player stats. Requires `hubcombat.admin` permission. ### 📌 Placeholders: - `%hubcombat_kills%` - `%hubcombat_deaths%` - `%hubcombat_hits%` - `%hubcombat_kdr%` - `%hubcombat_time_left%` - `%hubcombat_is_in_combat%` (returns "true" or "false") --- ## ⚙️ Installation & Usage 1. 📥 Drop the `.jar` into your `/plugins` folder. 2. 🔁 Restart the server. 3. ✅ H2 database is used by default — **no setup required**. - You can switch to **MySQL** for multi-lobby support. 4. 🗣️ Customize all messages via `lang.yml`. 🛡️ On join, players receive the weapon. PvP is enabled **only** if the weapon is equipped for the configured amount of time. 👊 Entities or players without the weapon **can't deal damage** — total control over hub PvP! --- ## Config: ``` # Available drivers: h2, mysql # If you are using h2, you don't need to specify the host, port, db-name, # username and password due to h2 is local database. database: driver: h2 host: 101.101.101.101 port: 3306 db-name: hubcombat username: userNaMeForHubCombat password: passw0rD timing: give-weapon: 5 remove-weapon: 5 # All the items from plugin # U can add as many loadouts as u want! Also, u can add as many items # as u want in the loadouts, just copy and paste the "template" for items loadouts: default: permission: hubcombat.loadout.default items: - slot: 4 material: DIAMOND_SWORD name: "<gray>Default Sword" lore: - "<white>Basic starter sword" enchantments: DAMAGE_ALL: 3 DURABILITY: 2 flags: - HIDE_ENCHANTS - HIDE_ATTRIBUTES vip: permission: hubcombat.loadout.vip items: - slot: 4 material: NETHERITE_SWORD name: "<green>VIP Sword" lore: - "<gold>Only for VIPs" enchantments: DAMAGE_ALL: 5 KNOCKBACK: 2 ``` ## 🛣️ Roadmap - 🗡️ Add **multiple weapons** via permissions. **-> ADDED** - 🛡️ Add **multiple armors** via permissions. **-> ADDED** - 🧩 More placeholders — suggest yours! !(https://tect.host/)! 10% OFF](https://cdn.modrinth.com/data/cached_images/4c74ad9ba6fd010e16adf4bb361f98e15bd79209_0.webp) # (https://tect.host/)