Britannia_BountyHunter

Overview

Britannia_BountyHunter turns bounty hunting into a career.

• The licence: hunters buy a bounty hunter licence from the lawman at a sheriff's office, or your server hands it out its own way (a job, staff, a document). Jobs can count as licensed without it.
• Contracts: at Valentine, Blackwater, Annesburg, Rhodes and Armadillo (G) each hunter gets their own board of wanted posters: name, crime, reward, tier, alive or dead or alive, how many clues, riders and a warning (may come quietly, known to run, keeps a fast horse, armed and dangerous). A new board every 30 minutes.
• The clue trail: each clue is a search area on the map with a gold route. Close in and the clue shows a gold light, a tall gold beam and a map blip: an item on the ground or a witness to question (G). Clues never sit in a lake or on a cliff. The last clue leads to one of 71 hideouts across the map.
• The outlaws: they react the moment they spot you. They give up, sprint away, ride off on a horse or fight, with their gang. A leader who would give up fights on while their gang stands. Get 150 m away from a fleeing outlaw and they're gone.
• The getaway (Horse thief and up): grab the leader and the gang mounts up and chases you; leave a hogtied outlaw lying on the ground too long and they work the ropes loose. Carry them or put them on your horse.
• Turning in: once caught, a message and a gold route take you to the nearest office. Hand them to the lawman (G): reward and XP, half pay for a dead outlaw on a dead-or-alive contract. Die while the outlaw is out and the contract fails.
• Five tiers, 20 levels: Petty thief, Horse thief, Highwayman, Murderer and Gang leader, each with bigger gangs, more health, better aim, bigger guns and bigger rewards. Every level adds 2% to rewards.
• Millions of contracts: names, crimes, hideouts, reactions and clues are put together at random.
• Staff tools: test contracts and teleports; all settings in the free Land Office (/britannia).
• English, Spanish and French.

Works in tandem with Britannia_Bounties. With both running, the bounty boards and the sheriff's offices open one board with everything: the NPC contracts, Civilians (the law's bounties on players), Hand in, the Tip Line for the law, Report a tip for everyone else, the licence, your hunt and your hunter record. Player bounties need this script's licence, and each one handed in counts in the hunter record with XP.

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

Requirements

• poggy_core (free), version 0.14.0 or newer.
• oxmysql.
• One of VORP, RSG Core or QBCore RedM (poggy_core connects the script to it).
• Optional: Britannia_Bounties (VORP; one board), Land Office (settings in game) and Notifications.

Install

1. Put the Britannia_BountyHunter folder in your resources.
2. Add ensure Britannia_BountyHunter to server.cfg, after ensure oxmysql and ensure poggy_core (and after ensure Britannia_Bounties if you run it).
3. Add the licence item (below), then restart the server. The table britannia_bountyhunter is created on the first start.

Items

SQL.sql (VORP) and installation/items_rsg_qbcore.txt (RSG Core / QBCore RedM) add bounty_licence, the bounty hunter licence. To use your own licence item, set Config.Licence.Item.

Configuration

Everything is in shared/config.lua (and the hideouts in shared/hideouts.lua), with a comment on each option, and in the Land Office.

Commands and permissions

Staff = the britannia_bountyhunter.admin ace, a group in Config.AdminGroups, or a poggy_core admin.

Exports for other scripts. Server: exports.Britannia_BountyHunter:HasLicence(source) and CivilianHandIn(source, alive, pay).

How it works

Contracts are made and kept by the server. Every step is checked there: the licence, reaching each clue, reaching the hideout, the outlaw beside the lawman, alive or dead. The reward, XP and levels are given by the server.

Troubleshooting

Take contract is greyed out. You need the licence (the card on the Contracts page sells it), you may already be on a contract, or you're waiting out the cooldown after the last one.

I can't find the clue. Ride to the yellow area: within 160 m the clue has a gold beam and a map blip.

The outlaws don't appear. Ride to within 120 m of the hideout (the last yellow area).

Turning in does nothing. Stand right by the lawman with the outlaw (hogtied, carried, on your horse, or dead on a dead-or-alive contract) within 8 m.

Version history

• 1.0.0: first release.