DexBounty · Configuration
Configuration
Everything lives in one config.yml. Text uses MiniMessage — hex like <#03fcb1> works everywhere.
GUI colour
One accent colour for the whole server. Players can't change it.
gui:
colour: "aqua"
Valid: aqua cyan blue purple magenta pink red orange yellow lime green brown white light_gray gray black
| Use | Where | Becomes |
|---|---|---|
<colour> | Any text | The accent colour |
<colour_dark> | Any text | A darker shade |
%colour% | Any material: | %colour%_DYE → CYAN_DYE |
Bounty rules
settings:
maximum-bounty: 100000000 # -1 = no limit
minimum-bounty: 1
allow-self-bounty: false
tax: -1 # 10 = 10% of every claim, -1 = off
broadcast-new-bounty: false
broadcast-claim: false
refund-on-remove: true
leaderboard-size: 10
claim-commands: [] # %killer% %player% %amount%
Anti-abuse
limits:
cooldown-seconds: 0 # between placements
max-per-day: -1
stat-blocking:
enabled: false
mode: "kd" # "kd" or "deaths"
minimum-kd: 0.5
maximum-deaths: 100
Auto-bounty & expiry
auto-bounty:
enabled: false
percent: 25 # of the claimed amount
minimum: 1
maximum: -1
expiry:
enabled: false
days: 14
refund: true
Tracker
tracker:
enabled: false
price: 5000
duration-seconds: 60
cooldown-seconds: 300
action-bar: true # distance + time left
warn-target: true
Discord webhook
discord:
enabled: false
webhook-url: ""
username: "DexBounty"
events:
placed:
title: "New bounty"
colour: "#e2620f"
description: "%setter% placed $%amount% on %player%"
claimed:
title: "Bounty claimed"
colour: "#2fd45f"
description: "%killer% claimed $%amount% for killing %player%"
Menu layout
gui.rows accepts 2–6. The bottom row holds the controls; everything above holds bounties, so 6 rows = 45 per page. Every control item takes enabled and slot. Page arrows only show when there's a page to go to.
gui:
title: "ʙᴏᴜɴᴛɪᴇs"
rows: 6
page-size: 0 # 0 = fill the content area
items:
info:
enabled: true
slot: 49
material: SKELETON_SKULL
name: "<colour><bold>ʙᴏᴜɴᴛɪᴇs"
# search (50), sort (48), previous-page (45), next-page (53) work the same way
Storage
storage:
type: "sqlite" # "mysql" shares bounties across a network
mysql:
host: "localhost"
port: 3306
database: "dexbounty"
username: "root"
password: ""
◆
With MySQL, every server on the same database sees — and can claim — the same bounties. SQLite data lives in plugins/DexBounty/data/storage.db.