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 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