🏴‍☠️ Bounty Redux

A free, open-source bounty plugin for Paper servers. Inspired by the DonutSMP Bounty Plugin.

---

⚡ Features

• Smooth bounty GUI with paginated player head display
• Add bounties on any player via command or GUI
• Confirmation menu to prevent accidental placements
• Cooldowns to prevent bounty spam
• Sort bounties by amount or name
• Search bounties by player name
• Vault economy integration
• Fully customizable messages via config.yml
• Tab completion on all commands
• SQLite persistence — bounties survive restarts
• 🔓 Full offline-mode server support — player skulls render correctly for all players, even when offline, even with SkinRestorer

---

📦 Dependencies

Dependency	Link
Vault	SpigotMC
EssentialsX (optional)	SpigotMC
SkinRestorer (optional, recommended for offline-mode servers)	SpigotMC

---

🔓 Offline Mode Server Support

Most bounty plugins render player skulls using Bukkit's offline player cache — which means skulls break the moment a player logs off, and offline-authenticated players never render at all.

This plugin fixes that properly:

• On every join, the player's skin texture (including SkinRestorer-injected skins) is cached directly into the local SQLite database
• Skulls are rendered from this texture cache — no dependency on whether the player is currently online
• Works out of the box with SkinRestorer — no extra configuration needed

---

🔧 Commands & Permissions

Command	Description	Permission
/bounty	Opens the bounty menu	bountyredux.use
/bounty add <player> <amount>	Add a bounty	bountyredux.add
/bounty search <player>	View a player's bounties	bountyredux.search
/bounty track <player>	Track player	bountyredux.track
/bounty clear <player>	Clear a player's bounties	bountyredux.clear
/bounty reload	Reload config	bountyredux.reload

Permission nodes:

• bountyredux.add — place bounties
• bountyredux.reload — reload config
• bountyredux.clear — clear bounties
• bountyredux.admin — full admin access
• bountyredux.* — all permissions

---

🚀 Installation

1. Download the latest .jar from Releases
2. Drop it in your server's /plugins folder
3. Restart the server
4. Edit plugins/BountyRedux/config.yml if needed

---

⚙️ Configuration

Default config.yml:

# ============================================
#   Bounty Redux Plugin — GPLv3
# ============================================

settings:
  # Minimum bounty amount a player can place
  min-bounty: 10
  # Maximum bounty amount a player can place
  max-bounty: 1000000
  # Cooldown in seconds between placing bounties
  add-cooldown: 60
  # GUI title
  gui-title: "§6§lBounty Menu"

tracking:
  # Cost mode: 'fixed' or 'percentage'
  cost-mode: percentage
  # Fixed cost in currency (e.g. 500 = $500)
  fixed-cost: 500
  # Percentage of the target's total bounty (e.g. 5 = 5%)
  percentage-cost: 5
  # Duration in seconds (default 300 = 5 minutes)
  duration: 300

messages:
  prefix: "§8[§6Bounty§8] §r"
  bounty-placed: "§aYou placed a bounty of §6${amount} §aon §e{target}§a!"
  bounty-collected: "§6{killer} §acollected the bounty of §6${amount} §aon §e{target}§a!"
  bounty-cleared: "§cThe bounty on §e{target} §chas been cleared."
  bounty-not-found: "§cNo bounty found for that player."
  no-permission: "§cYou don't have permission to do that."
  not-enough-money: "§cYou don't have enough money! You need §6${amount}§c."
  on-cooldown: "§cYou're on cooldown! Wait §e{seconds}s §cbefore placing another bounty."
  invalid-amount: "§cInvalid amount. Must be between §6${min} §cand §6${max}§c."
  cannot-bounty-self: "§cYou can't place a bounty on yourself!"
  player-not-found: "§cPlayer not found."
  plugin-reloaded: "§aPlugin reloaded successfully."
  bounty-confirmed: "§aYou confirmed a bounty of §6${amount} §aon §e{target}§a."
  bounty-cancelled: "§cBounty placement cancelled."
  no-bounties: "§cThis player has no bounties."

Available placeholders:

Placeholder	Description
{amount}	The bounty amount
{target}	The target player's name
{killer}	The killer's name
{seconds}	Remaining cooldown seconds
{min}	Minimum bounty amount
{max}	Maximum bounty amount

---

🛠️ Building from Source

git clone https://github.com/LightNabz/BountyRedux.git
cd bounties
mvn clean package

The built jar will be in /target/BountyRedux-{version}.jar.

---

📜 License

This project is licensed under the GNU General Public License v3.0.
See LICENSE for details.