Skip to content

Bounties

The bounty system lets organizations put a price on someone's head. In V2, bounties stack, hunters get live tracking, and targets can see who's coming for them.

How It Works

  1. A gang member with the place_bounties permission sets a bounty on a target through the UI
  2. The bounty appears for all criminals to see
  3. Hunters accept the bounty and can start tracking the target's location
  4. The target sees who is hunting them on their map
  5. Kill the target to collect the full bounty amount

Setting a Bounty

  • Done through the criminal UI (no command needed)
  • Requires the place_bounties role permission in your organization
  • Minimum amount: 200 currency (configurable)
  • The bounty cost is deducted from the player's currency immediately

Bounty Stacking

Multiple players can set bounties on the same target. When stacking is enabled, amounts combine into one big bounty:

lua
BountyStackEnabled = true,

TIP

With stacking enabled, a target could have a 200 bounty from one player, then another player adds 300 — the total bounty becomes 500. The hunter who kills them collects the full combined amount.

Live Tracking

Hunters Tracking the Target

After accepting a bounty, hunters can track the target's real-time location:

  • Click "Track" in the bounty UI
  • A red flashing blip appears on the target for 5 minutes
  • 15-minute cooldown between tracking uses
  • Target must be online to track

Target Seeing Their Hunters

The hunted player gets two-way awareness — they can see who's hunting them:

  • Red blips appear on the map for each active hunter
  • Blips update every 15 seconds with hunter positions
  • Shows the hunter's criminal name on the blip

INFO

This creates tense cat-and-mouse gameplay. The hunter knows roughly where the target is, but the target knows the hunter is coming.

Bounty Completion

When a hunter kills the bounty target:

  1. Hunter receives the full bounty amount as currency
  2. Hunter's bounties stat is incremented (counts toward criminal title progression)
  3. The bounty is deleted from the database
  4. Discord log is created (if enabled)

Consequences for the Target

What happens to the target when they're killed depends on your config:

Stat Wipe
Criminal stats are reset to zero. Titles revert back to Pickpocket. Enabled by default.
Inventory Wipe
Target's entire inventory is cleared on bounty death. Disabled by default.
Character Kill
The character is PERMANENTLY DELETED. Nuclear option — disabled by default.

DANGER

IsBountyCK = true will permanently delete the character on bounty death. This is irreversible. Use with extreme caution.

Continental Auto-Bounty

Kill someone in a continental safe zone and a bounty is automatically placed on you by the victim:

lua
KillInContinentalZoneSetBounty = true,
BountyPriceSetOnContinentalKill = 200,
  • If you already have a bounty, the amount stacks on top
  • The killer gets a notification and sound alert when the bounty is set
  • Continental zones are meant to be safe — this is the punishment for breaking that

Online Status

The bounty UI shows whether targets are currently online or offline, so hunters know if it's worth accepting right now. This updates in real-time.

Config

lua
-- Bounty Settings
IsBountyCK = false,                     -- Character Kill on completion
IsBountyStatWipe = true,                -- Wipe criminal stats on completion
IsBountyInventoryWipe = false,          -- Wipe inventory on completion
MinimalBounty = 200,                    -- Minimum bounty amount (currency)
BountyStackEnabled = true,             -- Allow multiple bounties to stack
BountyTrackCooldown = 15,              -- Minutes between tracking uses
BountyTrackDuration = 5,               -- Minutes the tracking blip shows

-- Continental Auto-Bounty
KillInContinentalZoneSetBounty = true,
BountyPriceSetOnContinentalKill = 200,

Role Permission

To allow organization members to place bounties, add the permission to their role:

lua
DefaultRoles = {
    {
        name = 'Leader',
        permissions = {
            place_bounties = true,
            -- ... other permissions
        }
    },
},