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