⚔️ CombatUtils

The everything-combat plugin for Paper servers. Stop gank squads, punish combat loggers, and give your PvP a real ruleset — all in one lightweight plugin with zero hard dependencies.

✨ Features

🛡️ Anti-Gank Attacker Limit

• Cap how many distinct players can simultaneously fight one victim
• Configurable engagement window and max-attacker count
• Blocked players get a boss bar, action bar, and chat feedback
• Protected players can't go pick fights with unrelated players while they're being ganked

🔥 Combat Tagging

• Live countdown boss bar while you're in combat
• Combat-log punishment: disconnect mid-fight and get killed (and publicly called out) on rejoin
• Staff alerts for combat-log events and repeated blocked-hit spam

🌍 Environment-Aware

• Automatically ignores creative/spectator players
• Skips Citizens NPCs
• Respects WorldGuard's PvP flag (soft-dependency, no crash if not installed)

🎒 Item & Weapon Restrictions

• Per-item cooldowns (ender pearls, notch apples, chorus fruit, anything you configure)
• Block specific items entirely while combat-tagged
• Per-fight use limits (e.g. 1 totem per fight) — with an upfront warning if you're carrying more than you're allowed
• Extra wind-up/reload delay for heavy weapons like the mace and trident

🚪 Escape Prevention

• Blocks /home, /tpa, /warp, /spawn, and any commands you configure while tagged
• Temporary spawn protection after respawning, with full chat feedback on start/end

🏆 Progression & Utility

• Killstreaks with server-wide milestone announcements
• Bounty system with configurable payout/charge commands (plug into any economy plugin)
• Persistent kill/death/KDR stats with a /combatutils top leaderboard
• Optional old-PvP (pre-1.9) mode per world
• Configurable knockback multiplier
• Autoclicker/killaura CPS flagging for staff (alerts only, no auto-punish)

🔧 Commands

Command	Description
/combatutils status	View current config
/combatutils reload	Reload config.yml — no restart needed
/combatutils simulate <player>	Test the attacker-limit pipeline solo
/combatutils bounty set/list/clear	Manage bounties
/combatutils top	View the kill/death leaderboard

Aliases: /cu, /combat

🔑 Permissions

• combatutils.admin — admin commands
• combatutils.bypass.limit / combatutils.exempt — bypass the attacker limit
• combatutils.bypass.checks — bypass environment checks
• combatutils.bypass.items — bypass item/weapon restrictions
• combatutils.bypass.commands — bypass escape-prevention
• combatutils.bounty / combatutils.stats — player-facing features

📋 Requirements

• Paper 1.21.x
• Java 21+
• (Optional) WorldGuard — PvP-flag checks activate automatically if installed

Every feature is individually toggleable in config.yml — turn off what you don't need.