⚔️ 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 Discord 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!

Tect.host