VIBE BOUNTY

☠ VIBEBOUNTY: THE ULTIMATE BOUNTY EXPERIENCE
Premium bounty plugin by VIBE STUDIOS

Put a price on anyone’s head. Beautiful menus, live bounty name tags, kill streaks, anti-abuse protection and full in-game configuration, all in one lightweight plugin.

Paper • Purpur • Spigot • Pufferfish | Minecraft 1.21.x – 26.x | Java 21+

━━━━━━━━━━━━━━━━━━━━

WHY VIBEBOUNTY?

Most bounty plugins are just a chat command and a number. VibeBounty turns bounties into a server event. Players browse a premium Bounty Board, pick a target and raise the stakes together, and the whole server sees exactly who’s wanted, right under their name. Kill the target and you take everything.

• Feels premium: polished menus, titles, sounds, lightning and broadcasts
• Drives PvP: every wanted player becomes a moving target with a visible price
• Fair: anti-alt and anti-farm protection built in
• Lightweight: no lag timers, async saving, starts in about 20 ms

━━━━━━━━━━━━━━━━━━━━

FEATURES

🏆 Premium Bounty Board
• Main menu with the live reward pool and the Most Wanted player
• Your Profile: bounty on you, bounties claimed, money earned and placed, kill streak, balance
• Active Bounties: every wanted player, highest reward first, with pages
• Top Hunters: a top-10 podium of the deadliest players

💰 Place Bounties in Seconds
• Pick an online player’s head, then use the + / − buttons, with a live tax breakdown
• Type any amount in chat: 25000, 10k, 2.5m
• Bounties stack, so many players can fund the same target
• Configurable minimum and maximum per bounty, maximum total per player, tax % and cooldown

☠ Live Bounty Name Tags
• Wanted players get a red “☠ $500,000” line under their name
• Updates instantly when a bounty is placed, raised, claimed or removed
• No teams, so it never breaks BetterTeams, TAB or rank prefixes
• Players without a bounty are never touched

⚔️ Hunt. Kill. Get Paid.
• The killer receives the entire reward
• Lightning strike, a “BOUNTY CLAIMED!” title, sounds and a server-wide broadcast
• Works with swords, bows, crossbows and tridents
• Every claim counts towards the Top Hunters leaderboard

🔥 Kill Streaks (can be turned on or off)
• Broadcasts every N kills in a row
• “X ended Y’s 10 kill streak!” announcements
• Best streak tracked for every player
• Optional server streak bounty, off by default, so only players place bounties unless you want it

⚙️ Configure Everything In-Game
• /vb settings: toggle features and change numbers with clicks
• Every change is saved to config.yml instantly
• Every message, title and menu text is editable in messages.yml
• Full hex color support (&#FF3B3B)

🛡️ Anti-Abuse Built In
• Same-IP protection: no payouts between alts on the same connection
• Funders can’t claim a bounty they helped pay for
• Cooldown between placing bounties
• No self-bounties

🔌 PlaceholderAPI Ready
• %vibebounty_bounty%: the bounty on a player
• %vibebounty_bounty_raw% / %vibebounty_has_bounty%: raw number / true or false
• %vibebounty_streak% / %vibebounty_best_streak%: current / best kill streak
• %vibebounty_claimed% / %vibebounty_earned% / %vibebounty_placed%: player stats
• %vibebounty_active%: number of active bounties
• %vibebounty_wanted<1-10>name% / amount%: the most wanted list
• %vibebounty_top<1-10>_name% / _earned%: the top hunters list

📦 Switch From Skript in One Command
Coming from a Skript bounty system? /vb import skript copies every bounty, contributor, stat and kill streak exactly. Your Skript files are only read, never changed, and VibeBounty backs up its own data first.

━━━━━━━━━━━━━━━━━━━━

COMMANDS

/bounty (aliases /bounties, /hunt): open the Bounty Board
/bounty set : place a bounty
/bounty check [player]: check a bounty
/bounty list: active bounties
/bounty top: top hunters
/vb settings: in-game settings menu (admin)
/vb remove : delete a bounty and refund everyone who paid (admin)
/vb import skript: import data from Skript (admin)
/vb reload, /vb save, /vb version: reload config, save data, show version (admin)

PERMISSIONS

vibebounty.use (everyone): Bounty Board, placing and checking bounties
vibebounty.admin (op): settings menu, removing bounties, reload, import

━━━━━━━━━━━━━━━━━━━━

INSTALLATION

Install Vault and an economy plugin (EssentialsX, CMI, and so on).
Put VibeBounty.jar in your plugins folder and restart.
That’s it. Change settings in-game with /vb settings, or edit config.yml and messages.yml and run /vb reload.
Optional: PlaceholderAPI for placeholders.

━━━━━━━━━━━━━━━━━━━━

COMPATIBILITY

✅ Paper, Purpur, Pufferfish, Spigot and other Bukkit forks
✅ Minecraft 1.21.x – 26.x (Java 21+; 26.x servers need Java 25)
✅ Tested on Paper 1.21.1, 1.21.11 and 26.3, and Purpur 1.21.11 and 26.3
✅ Covered by 34 automated tests
✅ Works alongside BetterTeams, TAB, LuckPerms prefixes and chat plugins
❌ Folia is not supported

━━━━━━━━━━━━━━━━━━━━

SUPPORT

Found a bug or have an idea? Contact VIBE STUDIOS. If you enjoy the plugin, a ⭐⭐⭐⭐⭐ review means the world!

☠ VibeBounty, by VIBE STUDIOS