ServerBounties

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.

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 suicides.
• 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

Permissions

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
  suicide-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