ServerBounties

Player bounties and hitman contracts for Paper/Purpur 1.21.x. Put a price on a player's head, or hire another player as a hitman through a full contract-negotiation system — all driven by GUIs and backed by your economy.

!Version !Minecraft !Java

Features

• Bounties — place money bounties on players; multiple players can contribute to the same target. A public bounty board, per-target detail views, and a top-bounties leaderboard.
• Proportional kill rewards — when a target dies, the bounty is distributed based on tracked PvP damage rather than only crediting the final hit, with a decision tree that handles environmental deaths and ✨s.
• Hitman system — players register as available hitmen with their own price and duration limits; clients hire them through GUIs.
• Contract negotiation — propose, counter-offer, accept, decline, and rescind contracts (with a client/hitman payout split slider) via dedicated menus.
• Anti-farming safeguards — configurable suspicious-death detection and thresholds to curb alt/repeat-kill abuse.
• BossBar target indicators — configurable bossbars for bounty and hitman targets.
• Economy — money in integer cents; prefers MultiBank (async) with a Vault fallback.
• Optional integrations (reflection, no hard dependency): CombatLOG, ServerFactions (e.g. same-faction rules), PlayerSettings (per-player language).
• Configurable taxes, broadcast thresholds, sounds, and fully configurable GUI layouts.
• Storage — SQLite (WAL) on a single-threaded executor, all queries parameterized.

Commands

Command	Description	Permission
/bounty (alias: /bounties)	Open the main menu	serverbounties.bounty
/bounty place	Open the place-bounty flow (select a player)	serverbounties.bounty
/bounty board	Open the bounty board	serverbounties.bounty
/bounty check <player>	View bounties on a player	serverbounties.bounty
/bounty my	View bounties you have placed	serverbounties.bounty
/bounty top	Show the top bounties in chat	serverbounties.bounty
/bounty remove <player>	Remove all bounties on a player (refunds)	serverbounties.admin
/bounty reload	Reload configuration and language	serverbounties.admin
/hitman (alias: /contract)	Open the main menu	serverbounties.hitman
/hitman my (or /hitman contracts)	Open your combined contracts view	serverbounties.hitman
/hitman contract	Open your active contract detail	serverbounties.hitman
/hitman settings	Open your hitman settings	serverbounties.hitman
/hitman board	Open the hitman board	serverbounties.hitman
/hitman hire <hitman>	Start a contract with a hitman pre-selected	serverbounties.hitman
/hitman register	Toggle your availability as a hitman	serverbounties.hitman

Permissions

Node	Description	Default
serverbounties.bounty	Place bounties and view the bounty board	true
serverbounties.hitman	Use the hitman contract system	true
serverbounties.admin	Admin commands (remove bounties, reload)	op

Configuration

Key sections of config.yml:

economy:
  mode: auto
  priority: ["MultiBank", "Vault"]

bounty:
  min-amount: 500
  max-amount-per-contribution: 1000000
  max-total-per-target: 10000000
  tax-rate: 0.10
  allow-offline-targets: false
  broadcast-threshold: 5000
  allow-same-faction: false
  cancel-blocked-in-combat: true

hitman:
  stale-negotiation-hours: 24
  anonymous-broadcast: true
  hitman-killed-client-percent: 85
  defaults:
    min-price: 100000
    min-hours: 1
    max-hours: 168
    max-concurrent: 3

damage-tracking:
  valid-kill-window-seconds: 300
  ✨-window-seconds: 150

anti-exploit:
  suspicious-death-threshold: 7
  suspicious-death-window-minutes: 60
  reveal-deathchest-coords: true

notifications:
  bounty-placed-broadcast: true
  target-bossbar: true

The full file also includes the complete sound set and detailed, per-menu GUI slot layouts.

Installation

1. Requires Paper or Purpur 1.21.x and Java 21.
2. Install an economy provider: either MultiBank, or Vault together with a Vault economy plugin (EssentialsX, CMI, etc.).
3. Drop ServerBounties-1.0.0.jar into your server's plugins/ folder.
4. Start the server to generate config.yml, then adjust amounts, tax rate, hitman defaults, and anti-exploit thresholds.
5. Run /bounty reload after editing configuration.

Dependencies

• Economy (one required): MultiBank or Vault + a Vault economy plugin.
• Optional integrations: CombatLOG, ServerFactions, PlayerSettings — all detected at runtime; none are required.

Support / Source

Source code: https://github.com/henriquescrrrr/carrageis-serverbounties