BetterBounty

BetterBounty ⚔️💰

Simple, fast, and Folia-supported bounty plugin for Minecraft servers.
Players can place bounties via a clean GUI, search names, sort by amount, bounty or name, and claim rewards
automatically on kill.

🍩 Exact replica of the DonutSMP's bounty system, now available for your server, for free!

Fully configurable with MiniMessage formatting, Vault economy support, and SQLite database.

Key Features ✨

• GUI-first: Paginated GUI with player heads, refresh, search, and sort controls.
• Search: In-game sign input to filter by player name
• Sorting: Toggle between Amount → Recently Set → Name
• Confirm flow: Add bounty through a confirmation GUI
• Vault economy: Money withdrawn on set; deposited to killer on kill
• Auto-save: Persists bounties to SQLite and saves every 15 minutes + on shutdown for more reliability
• Folia supported: Uses FoliaLib schedulers; folia-supported: true
• Config-driven: All messages and GUI texts can be customized easily
• Admin commands: Remove bounties, without hassle of editing databases manually

Requirements 📦

• Java: 21
• Server: Paper/Folia (1.19 - 1.21.11)
• Dependencies: Vault and a Vault-compatible economy provider

Installation 🚀

1. Install Vault and your economy plugin
2. Download the latest BetterBounty jar
3. Drop the downloaded jar into plugins/
4. Start the server and generate the config
5. Edit plugins/BetterBounty/config.yml as desired, then run /bounty reload

Commands ⌨️

• /bounty or /bounties — Open the bounties GUI (players only)
• /bounty add <player> <amount> — Start the confirm flow to add to a bounty (players only)
• /bounty remove <player> — Remove a player's bounty
• /bounty reload — Reload the plugin config

Permissions 🔐

• bounty.remove — Allow /bounty remove
• bounty.reload — Allow /bounty reload
• betterbounty.updatecheck — Receive update notifications on join

Notes 📝

• Adding bounties is player-only (not console)
• Targets must have joined the server at least once to be referenced
• Self-kills do not award bounty
• Player skins and names are updated on join for more accurate visuals and sorting

Configuration (MiniMessage) 🎨

All messages and GUI text use MiniMessage. Hex colors like <#03fcb1> are supported.
Check MiniMessage docs for more details.

Data storage 🗄️

• SQLite database at: plugins/BetterBounty/database.db
• Auto-saves every 15 minutes and on plugin disable for reliability

How it works (briefly) 🧠

• Placing a bounty deducts funds immediately using Vault
• Bounties are displayed in a paginated GUI with skull textures
• On death by another player, the killer is paid and the bounty is removed
• Player name and skin texture are refreshed on join for accurate sorting and visuals

Metrics 📈

This plugin uses bStats for anonymous usage statistics.
You can disable it in plugins/bStats/config.yml.