Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
BountySMP
-
New Big Update
-
Full Release
-
Many Bug Fixes
-
Better Gui
More coming soon
Features
BountySMP adds a bounty system to survival.
Players can take valuable items from their own inventory and put them on another player's head.
The player with the bounty has to survive. The longer they stay alive, the higher their stage gets and the stronger their effects become.
If another player kills them, the killer gets the bounty rewards, a Trophy Head, and the target's stage effects for 24 hours.
Most of the system can be managed through /bounty.
Bounties
- Use real items from your inventory
- Multiple players can place bounties on the same target
- Only configured items can be used
- Bounty progress survives server restarts
- Minimum bounty amount can be configured
Stages
Wanted players gain stages over time.
Each stage can give different potion effects.
The stage times and effects can all be changed in config.yml.
Rewards
When the target is killed:
- All bounty rewards go to the killer
- A Trophy Head is created
- The killer gets the target's current stage effects for 24 hours
- Rewards that don't fit can be claimed later
Wanted Tracker
Higher-stage targets can get:
☠ WANTED ☠
The marker is a floating TextDisplay and has no hitbox.
Targets can also leave a particle trail. The marker and particles can change color depending on the stage.
Commands
| Command | What it does |
|---|---|
/bounty |
Opens the Bounty Board |
/bounty menu |
Opens also the Bounty Board |
/bounty create <player> <amount> <item> |
Creates a bounty |
/bounty list |
Shows active bounties |
/bounty info <player> |
Shows bounty information |
/bounty claim |
Claims pending rewards |
/bounty top |
Opens the leaderboard |
/bounty help |
Shows the commands |
/bounty reload |
Reloads the plugin |
Admin
| Command | What it does |
|---|---|
/bounty admin setstage <player> <stage> |
Changes a player's stage |
/bounty admin removestage <player> [amount] |
Removes stages |
/bounty admin delete <player> [creator] |
Removes bounties and refunds them |
/bounty admin endall confirm |
Removes all bounties |
/bounty admin setbounty <player> <item> <amount> |
Creates a forced bounty |
/bounty admin addbounty <player> <item> <amount> |
Adds a normal bounty |
More Information
Detailed Information
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:
| Stage | Time | Effects |
|---|---|---|
| Stage 1 | 3 days | Strength I |
| Stage 2 | 7 days | Strength II, Resistance II |
| Stage 3 | 14 days | Strength III, Resistance III, Speed III |
| Stage 4 | 30 days | Strength III, Resistance III, Speed III, Regeneration III |
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.
New Features
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
Fixes & Improvements
- 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
| Permission | Default | Description |
|---|---|---|
bountysmp.use |
Everyone | Use the bounty system |
bountysmp.create |
Everyone | Create bounties |
bountysmp.top |
Everyone | Use the leaderboard |
bountysmp.reload |
OP | Reload the plugin |
bountysmp.admin |
OP | Admin commands |
Permissions can be changed in config.yml.
PlaceholderAPI
BountySMP supports PlaceholderAPI.
Player Placeholders
%bountysmp_bounty%— Bounty count%bountysmp_bounty_status%— WANTED / Clean%bountysmp_bounty_value%— Total bounty value%bountysmp_bounty_hunters%— Number of hunters%bountysmp_has_bounty%— Whether the player is wanted%bountysmp_stage%— Current stage%bountysmp_timeleft%— Time until next stage%bountysmp_claims%— Total claims%bountysmp_pending%— Pending rewards
Leaderboard Placeholders
%bountysmp_top_name_1%%bountysmp_top_value_1%%bountysmp_top_stage_1%%bountysmp_top_bounties_1%%bountysmp_hunter_name_1%%bountysmp_hunter_claims_1%
Replace 1 with any leaderboard position.
Allowed Bounty Items
# 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.
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
GUI
Main GUI
Settings
Top Bounties
Place Bounty
Item Selection
Item Amount
Confirm Bounty
Player Search Results
Player Search
