CouchBounty

# CouchBounty !(https://cdn.modrinth.com/data/cached_images/d57c6a7cb0c1467129cd492736a388ba5617b4b3.png) **Put a price on their head.** Players place money on other players, the bounty stacks, and whoever gets the kill takes the pot. ## How it works - Any player can place a bounty with `/bounty set <player> <amount>` — the money is withdrawn from their balance. - Multiple bounties on the same player stack into a single pot. - When the target is killed by another player, the killer receives the bounty and it resets to zero. Any kill Minecraft attributes to the killer counts — melee, projectiles, TNT, wolves, knockback into the void. - Only the killer sees the payout message; a server-wide broadcast is optional. - The target is notified when a bounty is placed on them — instantly if online, or on their next join if they were offline. ## Features - **Paginated GUI** — everyone with a bounty is listed as their player head, showing the total amount, the last setter and the number of contributors. Page arrows, close button, configurable sounds. - **PlaceholderAPI support** — ranked placeholders for a "Most Wanted" scoreboard. - **English & German language files** — MiniMessage formatting, every message editable, custom languages supported. - **Fully configurable** — minimum/maximum bounty, tax, self-bounties, anonymous setters, cooldown, payout percentage, broadcasts, sounds. - **Admin commands** — set bounties for free, reset them, reload the config without a restart. - **Config that survives updates** — new options are merged into your existing `config.yml` automatically; your values and comments stay untouched. ## Commands Aliases: `/bounty`, `/kopfgeld`, `/kopfgelder`, `/bounties` | Command | Description | Permission | |---|---|---| | `/bounty` | Open the bounty GUI | `bounty.use` | | `/bounty set <player> <amount>` | Place a bounty | `bounty.set` | | `/bounty check <player>` | Show a player's bounty | `bounty.use` | | `/bounty help` | Show the help | — | | `/bounty adminset <player> <amount>` | Set a bounty for free (`0` resets it) | `bounty.admin` | | `/bounty reset <player>` | Reset a player's bounty | `bounty.admin` | | `/bounty reload` | Reload config and language file | `bounty.admin` | ## PlaceholderAPI Identifier: `couchbounty`. Rank 1 is always the highest bounty. | Placeholder | Description | |---|---| | `%couchbounty_bountyname_1%` | Name of the player at rank 1 | | `%couchbounty_bountymoney_1%` | Formatted bounty at rank 1 | | `%couchbounty_bountymoney_raw_1%` | Plain number without currency symbol | | `..._2`, `..._3` | The following ranks | | `%couchbounty_count%` | Number of active bounties | | `%couchbounty_self%` / `%couchbounty_self_raw%` | The viewing player's own bounty | Ranks without a bounty return configurable values, so scoreboard lines never break. ## Requirements - **Paper 1.21.x** or a Paper fork — the plugin uses the Paper API and does not run on plain Spigot/Bukkit - **Java 21** - **Vault** and an economy plugin (e.g. EssentialsX) — without an economy provider the plugin disables itself and logs the reason - **PlaceholderAPI** — optional, only required for the placeholders ## Installation 1. Install Vault and an economy plugin. 2. Drop the jar into your `plugins` folder. 3. Start the server — the config and both language files are generated. 4. Adjust `plugins/CouchBounty/config.yml` and run `/bounty reload`.