Skip to main content

Bounties concept

This page explains how bounties work in dzbot from a gameplay and operations perspective.

What a bounty is​

A bounty is a paid objective placed on a target player — or on a whole faction.

  • The creator pays the full bounty amount immediately.
  • The bounty stays open until it is completed or canceled.
  • When completed, a configured payout share is paid to the eligible killer.

Bounties are part of the server economy and directly affect player balances. For the full money model, see Transactions concept.

Bounty lifecycle​

Each bounty moves through one of three statuses:

  • Open: active and waiting for completion or cancellation
  • Completed: target was eliminated and payout was calculated
  • Cancelled: bounty was stopped and refunded to the creator

Completion and payout model​

When an open bounty target is killed by a player with hitman access, the bounty is completed.

  • payout is calculated from the configured hitman cut percentage
  • payout goes to the killer
  • remaining amount stays as economy sink

Data freshness note: bounty-completion and target-position visibility rely on imported server logs and can appear with delay.

The payout percentage can be adjusted in the server settings.

Bounties on a faction​

Instead of one player, a bounty can target a whole faction. It works like a bounty on a player, with these differences:

  • The first kill of any member collects it. The hitman gets the configured share of the whole amount in one payout, and the bounty is done. Several open bounties on the same faction are all collected by that one kill.
  • Membership counts when the kill is processed (usually within minutes of the kill). A player who left the faction before that no longer counts; one who joined does.
  • Members cannot collect it. A kill between two members never counts, and neither does a kill by a player one of whose linked accounts is a member. Killing a member's alt that is not itself in the faction does not count either — only members are targets.
  • Nobody can place one on a faction they or one of their linked accounts belong to.
  • Hitmen see every member's last known position — on the bounties page, in Discord and on the map — just as they see a player target's.
  • Deleting the faction refunds its open bounties to whoever placed them.

Wallet history shows these bookings as Bounty placed on faction …, Bounty reward for eliminating … of faction … and Refund for bounty on faction ….

Allies and faction mates​

A bounty is meant for outsiders, so by default:

  • A kill pays no bounty when the killer is in the same faction as the victim or in a faction allied with the victim's faction. For a bounty on a faction, a killer who is a member of that faction or allied with it collects nothing. Linked accounts count as well: if one of the killer's accounts is a faction mate or ally, the kill does not pay.
  • You cannot place a bounty on a player of a faction allied with yours, or on a faction allied with yours.

When placing a bounty, the switch Allies and faction mates of the target may collect too (for a faction bounty: Members and allies of the target faction may collect too) lifts both rules. It is off by default. Use it for bounty events, for example, where anyone should be able to hunt. Bounties placed from Discord with /bounty always use the default.

Core configuration​

Bounty behavior depends on two key economy settings:

  • minimum bounty amount
  • hitman payout percentage

If the server subscription is inactive or expired, bounty flows are not available.

Visibility and control model​

Player-side visibility and actions depend on assigned rights:

  • regular players can manage their own bounty entries
  • hitman-enabled players can view open bounty listings
  • players with broader bounty control can cancel any open bounty

Bounties placed by actions​

Actions can place bounties too, with the Lua function bounty.create — the ready-made Auto Bounty action in the marketplace puts a bounty on every player who kills another player, optionally only inside the zones you pick.

  • By default the server funds such a bounty: nobody pays when it is placed, and the hitman's payout is new money. It shows in the hitman's wallet history as Server bounty reward for eliminating …, and in the admin bounty list as placed by Server (automation).
  • An action can instead charge a player (funded_by), who then pays up front like for a bounty they place themselves.
  • Withdrawing a server-funded bounty refunds nobody.
  • Otherwise it is a normal bounty: same payout rules, same alt-account coverage, same announcements. With allies_may_collect = true faction mates and allies of the target may collect it too.
  • With target_faction instead of target, an action places a bounty on a whole faction.

See bounty.create for the details.

Announcements and automations​

Bounty announcements are actions. A bounty on a player fires the bounty_placed event, a bounty on a faction fires faction_bounty_placed (with the faction and its members), and every collected bounty fires bounty_completed (hitman, victim, payout and the player or faction it was on). See In-app events.

Admin operations (overview)​

Admins can monitor and intervene from:

  • Server Admin -> Bounties

In this area, admins can review bounty history and refund open bounties (which cancels and refunds them).