VexCombatCore

The ultimate all-in-one combat manager for Paper servers.
Modern GUI, configurable rewards, and airtight combat-log protection — in one universal JAR.

---

✨ Why VexCombatCore?

• One JAR for every version — Works on Paper 1.21.3 through 26.3+ (Java 21).
• Next-Gen Dialog API — Smooth, interactive menus on 1.21.7+.
• Classic GUI fallback — Familiar chest menus for 1.21.3–1.21.6.

---

⚔️ Combat Features!

• Combat Tagging — Track fights with live BossBar & ActionBar countdowns.
• Safe Zone Barrier — Visual glass wall blocks tagged players from entering WorldGuard safe zones.
• Combat-Log Punishment — Choose KILL or DROP_INVENTORY when a tagged player quits.
• Newbie Protection — Auto-protects new players (admin bypass included).
• Anti-Clean — Drops are protected from other players for 5 seconds.
• Elytra & Pearl Control — Block or cooldown both items during combat.
• Kill Feed — Broadcast messages when a player kills another in combat.

---

🎨 Interactive Menus

• Item Selector GUI — Search and pick reward items visually.
• Set from Hand — Copy the item in your hand (enchantments, lore, NBT preserved).
• 25+ Settings — Configure everything via /vcc settings or config.yml.
• Stats & Bounties — Browse kills, deaths, and active bounties in-game.

---

🛠️ Commands & Permissions

Command	Description	Permission
/vcc	Shows the help message	vexcombat.use
/vcc menu	Opens the main menu	vexcombat.use
/vcc stats	Opens your combat stats	vexcombat.use
/vcc bounty	Opens active bounties	vexcombat.use
/vcc status	Check if you are in combat	vexcombat.use
/vcc settings	Opens the admin settings GUI	vexcombat.admin
/vcc reload	Reloads the config	vexcombat.admin
/vcc spawnbot	Spawns a test dummy	vexcombat.admin
/vcc removebots	Removes all test dummies	vexcombat.admin
/vcc newbie <player> <seconds>	Give/remove newbie protection	vexcombat.admin
/bounty <player> <amount>	Places a bounty on a player	vexcombat.use
/bounty list	Lists active bounties	vexcombat.use

---

⚙️ Dependencies & Integrations

• Required: Paper (or forks like Purpur) 1.21.3 – 26.3+, Java 21+.
• Optional: WorldGuard (safe-zone barriers).
• Optional: Vault (economy, rewards).
• No hard dependencies — works standalone without WorldGuard or Vault.

---

📦 Installation

1. Drop the JAR into plugins/.
2. Start the server to generate config.yml.
3. Configure your settings, or use /vcc settings in-game.

VexCombatCore is built for Paper. Optional integrations require WorldGuard and/or Vault.