🎯 BountyHunter

Place bounties on players, pool rewards, and hunt them down for profit. BountyHunter is a PvP bounty plugin for Paper 1.21 servers with full Vault economy integration, optional WorldGuard safe zones, and Geyser/Floodgate crossplay support.

---

✨ Features

• Pooled bounties — multiple players can contribute to the same target's bounty pool
• Bounty expiry — bounties expire after a configurable time (default: 48h) with partial refunds
• Extend bounties — pay a small fee to keep your bounty alive longer
• Wealth gate — prevents low-balance players from piling onto high-value targets
• Placement cooldown — stops spam bounties on the same player
• Safe zones — WorldGuard region support to block bounty collection in protected areas
• Anti-self-farming — you cannot collect bounties you placed yourself; same-IP kills are logged to console
• Gamemode protection — bounties can't be collected in Creative or Spectator
• Actionbar reminders — players with a bounty on their head are reminded periodically
• Offline notifications — missed messages are delivered when the player logs back in
• Leaderboard — track top bounty hunters by total earnings
• Collection history — paginated log of recent kills and payouts
• Crossplay support — Bedrock players tagged with [BE] via Floodgate
• Persistent storage — data saved to JSON files (bounties, history, leaderboard, notifications)
• Auto-save — data is saved every 5 minutes and on shutdown

---

📦 Requirements

Dependency	Required?
Vault	✅ Required
WorldGuard	⚡ Optional (safe zones)
Floodgate	⚡ Optional (Bedrock crossplay)

---

🛠 Commands

Command	Description	Permission
/bounty set <player> <amount>	Place a bounty on a player	bountyhunter.use
/bounty remove <player>	Cancel your bounty (partial refund)	bountyhunter.use
/bounty extend <player>	Extend your bounty duration	bountyhunter.use
/bounty list [page]	View all active bounties	bountyhunter.use
/bounty top	View the hunter leaderboard	bountyhunter.use
/bounty info <player>	Detailed info on a player's bounties	bountyhunter.use
/bounty history [page]	Recent bounty collections	bountyhunter.use
/bounty reload	Reload the config	bountyhunter.admin

---

🔑 Permissions

Permission	Default	Description
bountyhunter.use	Everyone	Use all bounty commands
bountyhunter.admin	OP	Reload the config

Spoiler