WantedBounties

WantedBounties turns PvP grudges into server-wide events. Anyone can put money on a player's head, everyone can pile onto the same target, and the pool keeps climbing until a hunter collects — with lightning, a firework, a server-wide sound and a gradient broadcast so nobody misses it.

Built the way you expect a modern plugin to be built: every menu is its own yml, every string lives in a lang file, every message is MiniMessage with hex gradients, and config updates merge new options in without touching your edits.


⚑ ᴘᴏᴏʟᴇᴅ ʙᴏᴜɴᴛɪᴇꜱ

• /bounty set <player> <amount> — money is taken instantly and held in database-backed escrow.
• Bounty pooling — any number of players can add to the same target. Every contributor and amount is tracked; the head is worth the sum.
• Anonymous bounties — add -a and pay a configurable fee to show up as Anonymous everywhere.
• Your rules — min/max amounts, placement tax, placement cooldown, offline targets on/off, self-bounties blocked, exempt permission.
• Shorthand amounts — 2.5k, 1m and friends work everywhere an amount is typed.
• Placement broadcast — gradient-formatted, shows the target's new total, toggleable.

☠ ᴄʟᴀɪᴍɪɴɢ & ᴀɴᴛɪ-ᴀʙᴜꜱᴇ

Kill a bountied player and the full pool is yours, minus an optional claim tax. The server hears about it: lightning at the death spot, a crimson firework, a global sound and titles for both hunter and target — every effect its own toggle.

The rules that keep it fair, all configurable:

• No self-cashing — a hunter can never claim money they contributed. Their share is refunded; they only earn what others put up.
• Pair cooldown — repeat kills on the same target inside the window (default 1 hour) pay nothing and don't broadcast. Survives restarts.
• Fresh-spawn protection — optionally require the target to have been online X minutes since the last claim on them.
• Blocked worlds — no claims in worlds you list.

⚠ ᴡᴀɴᴛᴇᴅ ᴛɪᴇʀꜱ

The bigger the pool, the louder the reputation. Tiers live in tiers.yml — add, remove or rename as many as you want. Each tier has a gradient name, a threshold, an entry broadcast, an optional particle aura that circles the target in-game, and prefix/suffix placeholders for your chat plugin.


▦ ᴛʜᴇ ʙᴏᴜɴᴛʏ ʙᴏᴀʀᴅ

/bounty opens a paginated board of every active bounty as player heads — total, tier, contributor count, time active and online status in the lore.

• Sort buttons — highest bounty, newest, oldest. The active sort glows.
• Search — click the spyglass, type a name in chat, the board filters instantly.
• Detail view — click any head: full contributor list (anonymity respected), dates placed, and an Add to Bounty button with a chat-input prompt.
• Your own head — a corner item shows your current bounty and tier. Sleep well.

★ ʟᴇᴀᴅᴇʀʙᴏᴀʀᴅꜱ & ꜱᴛᴀᴛꜱ

/bounty top opens a three-tab GUI: Top Hunters (most claimed), Top Earners (most money made hunting) and Most Wanted (biggest heads right now — click through to the detail view). /bounty stats prints a gradient stat card: claimed, earned, times bountied, bounties survived.

◈ ᴄʀᴀꜱʜ-ꜱᴀꜰᴇ ᴇꜱᴄʀᴏᴡ

• Money is withdrawn on placement and written to the database before the bounty goes live — payouts and refunds only happen after the escrow rows are deleted. A crash can't duplicate money or make it vanish.
• Expiry — bounties optionally expire after X days (default 7, 0 = never). Contributors are refunded (or the money is kept — your call), including offline players.
• Admin removals refund contributors too (configurable).

✎ ᴄᴏɴꜰɪɢᴜʀᴇ ᴇᴠᴇʀʏᴛʜɪɴɢ

• menus/*.yml — every GUI is its own file: title, rows, filler, and every item's slots, material, name, lore and click behaviour. Move buttons anywhere, delete what you don't want.
• lang.yml — every player-facing string, MiniMessage everywhere, configurable prefix. Set any message to '' to silence it.
• config.yml versioning — updates merge new options into your file without wiping your edits.
• /bounty admin reload — reloads config, lang, tiers and every menu. No restart.

▸ ᴄᴏᴍᴍᴀɴᴅꜱ & ᴘᴇʀᴍɪꜱꜱɪᴏɴꜱ

✦ ᴘʟᴀᴄᴇʜᴏʟᴅᴇʀᴀᴘɪ

Perfect for scoreboards, tab lists, chat prefixes and holographic leaderboards.

⚙ ɢᴇᴛᴛɪɴɢ ꜱᴛᴀʀᴛᴇᴅ

1. Drop WantedBounties-1.0.jar into your plugins folder and restart.
2. Want money bounties? Have Vault + any economy installed. The plugin runs without them — money features just disable.
3. Tune config.yml, tiers.yml, lang.yml and menus/*.yml, then /bounty admin reload.