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 ✨

- 🍩 Admin commands: Paginated GUI with player heads, refresh, search, and sort controls. - 🔎 Admin commands: In-game sign input to filter by player name - 🔀 Admin commands: Toggle between Admin commands - ✅ Admin commands: Add bounty through a confirmation GUI - 🏦 Admin commands: Money withdrawn on set; deposited to killer on kill - 💾 Admin commands: Persists bounties to SQLite and saves every 15 minutes + on shutdown for more reliability - 🍃 Admin commands: Uses FoliaLib schedulers; `folia-supported: true` - ⚙️ Admin commands: All messages and GUI texts can be customized easily - 🛡️ Admin commands: Remove bounties, without hassle of editing databases manually

Requirements 📦

- ☕ Dependencies: 21 - 🖥️ Dependencies: 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`.