bBounty

A modern Bounty plugin for Spigot/Paper (Paper 1.21.11) with legacy fallback via Maven profile. Designed to be modular, configurable and compatible with multiple economy providers.

TAB (neznamy) conditions

Add this condition block to your TAB (neznamy) configuration (under the conditions section in your config.yml, after doing this, add the condition in your groups.yml):

conditions:
  bounty:
    conditions:
      - "%bbounty_amount%!=0"
    true: " &b$%bbounty_amount%"
    false: ""

Explanation:

conditions.bounty.conditions contains one or more expressions evaluated for the player.

Here %bbounty_amount%!=0 returns true when the player's bounty is not zero.

true is the string to output when condition is true (shows cyan money with amount).

false is the string to output when condition is false (empty string hides suffix).

Then place the condition in your tab configuration where you accept condition placeholders.

Example for tab plugin tabsuffix setting:

tabsuffix: "%condition:bounty%"

This will: Render &b$ when the player's bounty is not zero.

Render nothing when the player's bounty is zero, effectively hiding the suffix.

Examples

Player with 0 bounty → tabsuffix becomes empty.

Player with 150 bounty → tabsuffix becomes &b$150 (styled according to plugin settings).

Overview

bBounty allows players to set monetary bounties on other players, claim rewards on kill, track streaks, and offers admin tools for managing bounties. It supports Vault or command-based economy providers and provides both modern Adventure messages and legacy fallback.

Bounties are also set automatically by the plugin to players with a random chance! (feature customizable in the config.yml)

Features

• Set bounties via /bounty set <player> <amount>
• Withdraw money from setter (configurable)
• Random auto-bounties on kill with probability scaling by streak
• Kill streak tracking and anti-farm cooldowns
• Reward payout to killer via configurable economy provider
• Admin commands and GUI-friendly placeholders
• Broadcast messages (configurable) for set, claim, auto-add
• Update checker with immediate check and scheduled checks
• PlaceholderAPI support

Commands

Player:

• /bounty set <player> <amount> - Set a bounty (withdraws money if enabled)
• /bounty info [player] - View bounty info
• /bounty top [page] - View top bounties
• /bounty streak [player] - View kill streak
• /bounty stats - View bounty statistics

Admin:

• /bounty admin add <player> <amount> - Force add bounty without cost
• /bounty remove <player> - Remove a player's bounty
• /bounty blacklist add <player> - Add player to blacklist
• /bounty blacklist remove <player> - Remove player from blacklist
• /bounty reload - Reload config
• /bounty checkupdate (or /bounty check) - Force update check (permission dbounty.admin)

Placeholders

📊 Basic Plugin Stats
%bbounty_active_count% - How many active bounties (number)

%bbounty_total_pool% - Total money in all bounties ($)

%bbounty_version% - Plugin version (like "2.1.0")

⚙️ Config Settings

%bbounty_config_min_set% - Minimum bounty you can set ($)

%bbounty_config_max_bounty% - Maximum bounty you can set ($)

%bbounty_config_auto_min% - Auto-bounty minimum ($)

%bbounty_config_auto_max% - Auto-bounty maximum ($)

🥇 #1 Leader (Top Target)

%bbounty_target_name% - Name of #1 bounty target

%bbounty_target_amount% - Their bounty amount ($)

🏆 Top Players List (replace # with 1, 2, 3...)

%bbounty_top_name_1% - #1 player's name

%bbounty_top_amount_1% - #1 player's bounty ($)

%bbounty_top_streak_1% - #1 player's kill streak

%bbounty_top_setter_1% - Who set #1's bounty

Examples: %bbounty_top_name_3% = #3 player name

👤 Specific Player Info (replace "PlayerName")

%bbounty_player_amount_PlayerName% - Player's bounty ($)

%bbounty_player_streak_PlayerName% - Player's streak

%bbounty_player_rank_PlayerName% - Player's rank (#)

%bbounty_player_has_bounty_PlayerName% - true/false

Example: %bbounty_player_amount_Steve%

🎯 Current Player Info

%bbounty_amount% - Your bounty ($)

%bbounty_streak% - Your kill streak

%bbounty_has_bounty% - true/false (you have bounty?)

%bbounty_rank% - Your rank (#)

%bbounty_setter% - Who set your bounty

%bbounty_auto_chance% - Auto-bounty chance %

%bbounty_reward_if_killed% - Reward if you kill them ($)

%bbounty_updated_at% - When bounty was last updated

%bbounty_setter_uuid% - Setter's UUID

Configuration (example)

Main relevant snippets of config.yml (defaults):

bounty:
  min-set-amount: 50.0
  max-amount: 1000000.0
  charge-setter: true

auto-bounty:
  enabled: true
  base-chance: 0.25
  per-streak-chance: 0.02
  max-chance: 0.75
  min-amount: 50.0
  max-amount: 1000.0

anti-farm:
  same-target-cooldown-seconds: 60

# Economy Provider Configuration
# Options: vault, commands, none
economy:
  provider: "vault"

  # If provider is 'commands', configure custom withdraw/deposit commands
  commands:
    # Withdraw money from player
    withdraw: "eco give %player% -%amount%"
    # Deposit money to player
    deposit: "eco give %player% %amount%"

reward:
  fallback-commands:
    - "eco give %player% %amount%"

blacklist:
  enabled: true
  players: []

messages:
  fancy-font-enabled: false
  bounty-set: "&b✦ &7Bounty set on &b%target% &7for &b%amount%"
  target-notify: "&b✦ &7A bounty was placed on you: &b+%amount%"
  reward-paid: "&b✦ &7You claimed &b%amount% &7from bounty."
  reward-failed: "&b✦ &7Bounty claimed but reward failed (economy/fallback)."
  auto-bounty-added: "&b✦ &7You gained attention: bounty &b+%amount%$"
  farm-blocked: "&b✦ &7Kill ignored (anti-farm)."
  no-permission: "&b✦ &7You don't have permission."
  player-not-found: "&b✦ &7Player not found."
  insufficient-balance: "&b✦ &7Insufficient balance."
  bounty-removed: "&b✦ &7Bounty removed: &b%amount%"
  player-blacklisted: "&b✦ &7Player &b%player% &7added to blacklist."
  player-unblacklisted: "&b✦ &7Player &b%player% &7removed from blacklist."
  admin-bounty-set: "&b✦ &7Admin bounty set on &b%target% &7for &b%amount%"

  # Broadcast messages visible to all players (enable/disable individually)
  broadcast-on-set-enabled: false
  broadcast-on-set: "&b✦ &7Bounty set on &b%target% &7for &b%amount%"

  broadcast-on-claim-enabled: true
  broadcast-on-claim: "&b✦ &7%killer% has claimed &b%amount% &7from &b%target%"

  broadcast-on-auto-added-enabled: true
  broadcast-on-auto-added: "&b✦ &7%player% gained attention: bounty &b+%amount%"

# Update checker settings
update-check:
  # Maximum allowed is 360 (6 hours). If >360 is set, plugin falls back to 360.
  frequency-minutes: 360