Britannia_Bounties

Overview

Britannia_Bounties puts the law in charge of who is wanted, and lets the rest of the server hunt them down.

• Bounties from the law: your law jobs post a bounty on a player with /bounty: the reward, jail time, alive only or dead or alive, where they were last seen, a note and an optional picture.
• Bounty boards in Valentine, Blackwater, Annesburg, Rhodes and Armadillo (G). The law and bounty hunters see the wanted posters and Hand in; everyone else can only Report a tip, so ordinary players never see who is wanted.
• The Tip Line: locals who see a wanted player with their face uncovered report them, and players report sightings with a note. Each tip goes on the Tip Line, which only the law sees: who, where, when, mark it on the map, cross it off. The law gets a "New tip" message and the poster's "last seen" changes to the nearest town.
• Capture and hand in: hogtie the wanted player, press G (Capture Bounty) beside them, take them to a turn-in spot at a sheriff's office and press Q (Turn In Bounty). The hunter is paid and the prisoner goes to jail for the bounty's time.
• Jail built in: a simple Sisika jail (cell, kept in if they wander, let out at the dock when their time is up, also after leaving and coming back). With Britannia_Admin running, its jail is used instead; any other jail script can be plugged in.
• Fair pay: bigger bounties pay a smaller share (dynamic weighting), dead targets pay less, your bounty hunter job is paid in full and others get a little less.
• NPC bounty missions: 10 ready-made missions with clue trails and armed gangs, for a Locals tab when you want one.
• Staff tools: cancel and list bounties; all settings in the free Land Office (/britannia).

Works in tandem with Britannia_BountyHunter. With both running, the bounty boards and the sheriff's offices open one board with everything: Civilians (the law's player bounties), the Tip Line, Report a tip, Hand in, the NPC contracts, the bounty hunter licence, levels and the hunter record. Claiming a player bounty then needs the bounty hunter licence, and each hand-in counts in the hunter's record.

The Lua is encrypted by Cfx.re; the settings, the NPC missions and the text stay editable.

Requirements

• VORP only: vorp_core (this script talks to VORP directly; it does not run on RSG Core or QBCore RedM).
• oxmysql.
• Optional: Britannia_BountyHunter (one board, the licence), Britannia_Admin (its jail), Land Office (settings in game).

Install

1. Put the Britannia_Bounties folder in your resources.
2. Add ensure Britannia_Bounties to server.cfg, after ensure oxmysql and ensure vorp_core.
3. Run install.sql in your database (the bounty table). The tip line and jail tables are created on the first start.
4. Set your law jobs in config.lua (Config.Permissions and Config.LawJobRestriction.LawJobs), then restart the server.

Items

None.

Configuration

Everything is in config.lua (and the NPC missions in npc_config.lua), with a comment on each option, and in the Land Office.

Commands and permissions

Staff = a character in one of Config.AdminGroups.

Exports for other scripts. Server: exports.Britannia_Bounties:GetActivePlayerBounties(), BoardFor(source), SubmitTip(source, bountyId, note), DismissTip(source, id). Client: IsBandanaOn(), IsFaceCovered().

How it works

Bounties, tips and jail sentences are kept by the server. Every capture and hand-in is checked there: the bounty is active, the target is online and hogtied by the hunter, the licence when one is needed, and the law restriction. Payment is worked out on the server and the prisoner is jailed from there. Expired bounties are cleared on a timer.

Troubleshooting

Nobody can post bounties. Your law job names must match Config.Permissions exactly (the character's job).

The law sees no Tip Line. Only jobs in Config.Permissions see it. Use /boardcheck to see what the board thinks of a player.

"Capture Bounty" never shows. The target must be hogtied and have an active bounty; law jobs can't capture while Config.LawJobRestriction.RestrictPlayerBounties is on; with Britannia_BountyHunter running, the hunter needs its licence.

Nobody goes to jail. With your own jail script, put its call in Config.JailPlayer. Otherwise the built-in jail is used.

Version history

• 1.0.0: first release.