Bounty Creation

Players pay for bounties using items from their own inventory.

For example:

/bounty create Steve 32 diamond

The 32 diamonds are removed from the player's inventory and stored as the bounty.

The plugin checks the configured bounty rules before accepting it.

Survival Stages

A player starts progressing through stages after receiving a bounty.

The default stages are:

These are only the default values. Everything can be changed in config.yml.

Stage progress uses stored timestamps, so restarting the server doesn't reset it.

Killing a Target

When a wanted player is killed, the killer receives the bounty.

The killer also gets a Trophy Head containing information about the kill.

The target's current effects are given to the killer for 24 hours.

After the target dies, their bounty and stage progress are reset.

GUI

The /bounty GUI contains several menus:

• Bounty Board
• Player Select
• Search
• Item Select
• Amount Select
• Confirm
• Bounty File
• Leaderboard
• Settings

The layouts, items, slots, titles and text can be changed in gui.yml.

GUI

• Player search
• Most Wanted leaderboard
• Top Hunters leaderboard
• Board sorting
• Compact board
• Claim Rewards button
• 5 GUI themes
• Live theme preview
• More personal settings

Tracker

• New floating ☠ WANTED ☠ TextDisplay
• Stage-based colors
• Stage-based particle colors
• Configurable marker text
• Better marker cleanup and recovery

Player Settings

Players can now change things like:

• Board sorting
• Compact board
• Threat badges
• GUI design
• Sounds
• Messages
• Stage alerts
• Bounty alerts
• Claim summaries
• Reward overflow
• Anonymous bounties
• Stage bossbar

Rewards

• Pending rewards
• Trophy Head claiming
• Full-inventory handling
• Claim in Menu
• Drop on Ground

• Fixed bounty amount buttons
• Fixed the empty-board compass
• Fixed missing orange tracking particles
• Fixed the {tier} placeholder
• Fixed issues causing game crashes
• Fixed issues causing server crashes
• Improved performance
• Improved security checks
• Improved tracker cleanup
• Improved GUI handling
• Improved database migrations

Permissions can be changed in config.yml.

BountySMP supports PlaceholderAPI.

Player Placeholders

1. %bountysmp_bounty% — Bounty count
2. %bountysmp_bounty_status% — WANTED / Clean
3. %bountysmp_bounty_value% — Total bounty value
4. %bountysmp_bounty_hunters% — Number of hunters
5. %bountysmp_has_bounty% — Whether the player is wanted
6. %bountysmp_stage% — Current stage
7. %bountysmp_timeleft% — Time until next stage
8. %bountysmp_claims% — Total claims
9. %bountysmp_pending% — Pending rewards

Leaderboard Placeholders

1. %bountysmp_top_name_1%
2. %bountysmp_top_value_1%
3. %bountysmp_top_stage_1%
4. %bountysmp_top_bounties_1%
5. %bountysmp_hunter_name_1%
6. %bountysmp_hunter_claims_1%

Replace 1 with any leaderboard position.

# Netherite and Diamond tier
- NETHERITE_INGOT
- NETHERITE_SCRAP
- DIAMOND
- DIAMOND_BLOCK
- NETHERITE_BLOCK
# Valuable resources
- EMERALD
- EMERALD_BLOCK
- GOLD_INGOT
- GOLD_BLOCK
- IRON_BLOCK
- LAPIS_BLOCK
- REDSTONE_BLOCK
# Rare and special items
- ENCHANTED_GOLDEN_APPLE
- GOLDEN_APPLE
- TOTEM_OF_UNDYING
- NETHER_STAR
- BEACON
- DRAGON_EGG
- ELYTRA
- SHULKER_SHELL
- HEART_OF_THE_SEA
- TRIDENT
- DRAGON_HEAD
- ENDER_CHEST
# Unique or late-game materials
- ANCIENT_DEBRIS
- OBSIDIAN
- END_CRYSTAL
- WITHER_SKELETON_SKULL
- BLAZE_ROD
- GHAST_TEAR
- PHANTOM_MEMBRANE
# Rare utility items
- ENCHANTED_BOOK
- EXPERIENCE_BOTTLE
- NAME_TAG
- SADDLE
- CONDUIT
- TURTLE_HELMET
# Optional event or economy items
- PLAYER_HEAD
- MUSIC_DISC_13
- MUSIC_DISC_PIGSTEP
- MUSIC_DISC_OTHERSIDE
- MUSIC_DISC_RELIC

More items can be added or removed in config.yml.

 BountySMP - main configuration
 Player-facing text lives in messages.yml


 GUI layout lives in gui.yml

database:
  file: "bountysmp.db"

bounty:
  minimum-amount: 1
  one-bounty-per-creator-target: true
  allowed-bounty-items:
    - NETHERITE_INGOT
    - NETHERITE_SCRAP
    - DIAMOND
    - DIAMOND_BLOCK
    - NETHERITE_BLOCK
    - EMERALD
    - EMERALD_BLOCK
    - GOLD_INGOT
    - GOLD_BLOCK
    - IRON_BLOCK
    - LAPIS_BLOCK
    - REDSTONE_BLOCK
    - ENCHANTED_GOLDEN_APPLE
    - GOLDEN_APPLE
    - TOTEM_OF_UNDYING
    - NETHER_STAR
    - BEACON
    - DRAGON_EGG
    - ELYTRA
    - SHULKER_SHELL
    - HEART_OF_THE_SEA
    - TRIDENT
    - DRAGON_HEAD
    - ENDER_CHEST
    - ANCIENT_DEBRIS
    - OBSIDIAN
    - END_CRYSTAL
    - WITHER_SKELETON_SKULL
    - BLAZE_ROD
    - GHAST_TEAR
    - PHANTOM_MEMBRANE
    - ENCHANTED_BOOK
    - EXPERIENCE_BOTTLE
    - NAME_TAG
    - SADDLE
    - CONDUIT
    - TURTLE_HELMET
    - PLAYER_HEAD
    - MUSIC_DISC_13
    - MUSIC_DISC_PIGSTEP
    - MUSIC_DISC_OTHERSIDE
    - MUSIC_DISC_RELIC

stages:
  definitions:
    1:
      required-survival-time: "3d"
      effects:
        - "STRENGTH:0"
    2:
      required-survival-time: "7d"
      effects:
        - "STRENGTH:1"
        - "RESISTANCE:1"
    3:
      required-survival-time: "14d"
      effects:
        - "STRENGTH:2"
        - "RESISTANCE:2"
        - "SPEED:2"
    4:
      required-survival-time: "30d"
      effects:
        - "STRENGTH:3"
        - "RESISTANCE:3"
        - "SPEED:3"
        - "REGENERATION:3"

effects:
  killer:
    duration: "24h"
  target:
    refresh-interval-ticks: 6000

checks:
  stage-check-interval-ticks: 1200

gui:
  enabled: true

tracker:
  enabled: true
  minimum-stage: 3
  glow:
    enabled: true
    color: RED
    stage-colors:
      3: ORANGE
      4: RED
      5: RED
      6: DARK_RED
  marker:
    text: "&l☠ WANTED ☠"
  trail:
    enabled: true
    particle: DUST
    interval-ticks: 10
    count: 7
    spread: 0.3
    y-offset: 0.8
    speed: 0.02
    dust-size: 1.4

top:
  wanted:
    default-item-value: 1.0
    item-values:
      NETHERITE_INGOT: 48
      NETHERITE_SCRAP: 24
      NETHERITE_BLOCK: 432
      ANCIENT_DEBRIS: 24
      DIAMOND: 16
      DIAMOND_BLOCK: 144
      EMERALD: 12
      EMERALD_BLOCK: 108
      GOLD_INGOT: 4
      GOLD_BLOCK: 36
      NETHER_STAR: 256
      BEACON: 320
      TOTEM_OF_UNDYING: 64
      ELYTRA: 192
      TRIDENT: 160
      ENCHANTED_GOLDEN_APPLE: 32
      DRAGON_EGG: 1024
      HEART_OF_THE_SEA: 128
      CONDUIT: 96
      WITHER_SKELETON_SKULL: 24

placeholders:
  refresh-seconds: 60
  leaderboard-size: 10

trophy:
  enabled: true
  glow: true
  name: "&6&l☠ {victim}'s Head ☠"
  date-format: "dd/MM/yyyy"
  lore:
    - "&8&m                              "
    - "&7Victim: &e{victim}"
    - "&7Hunter: &e{hunter}"
    - "&7Killed on: &e{date}"
    - "&7Bounty Value: &6{value}"
    - "&7Rewards: &e{rewards}"
    - "&8&m                              "
    - "&6★ Bounty Trophy ★"

permissions:
  use: "bountysmp.use"
  create: "bountysmp.create"
  reload: "bountysmp.reload"
  admin: "bountysmp.admin"
  top: "bountysmp.top"

debug:
  enabled: false