A treasure hunt across the whole city.

Every player gets their own door as a photo from the door hunter. Somewhere in Los Santos that door is waiting. Find it, knock and open it before the round runs out. Exactly one reward is behind every door. When the time is up, a new door is assigned. Whoever finds the most doors takes the top spot on the leaderboard.

Door Hunt gives your players a reason to explore the map, talk about locations and come back every round.

How it works

1. Talk to the door hunter and open the menu.

2. Look at the photo of your door and read the hints.

3. Find the door in the city and knock.

4. Collect your reward and climb the leaderboard.

Features

• Own door for every player: A personal door, picked at random from 59 included locations with photos. The same door never comes twice in a row. Round, timer and finds survive relogs and server restarts.

• Hints that unlock over time: First the district, then the street, at the end a search area on the map. Timing and order are set in the config.

• Knocking instead of a button press: The player knocks for a few seconds with an animation. The server checks distance, round time and knock duration.

• Weighted rewards: Items, weapons, money (cash, bank, dirty money) and vehicles. Chances are weights, the script works out the percentages.

• No rerolling through a full inventory: If the reward does not fit, the door stays open and the same reward is handed out on the next knock.

• Buy a new door: Players who do not like their door buy a new one with bank or cash, with a confirmation step. After a find this stays locked until the round runs out.

• Leaderboard: The best hunters, your own place and how many doors you need for the next spot.

• Rewards tab: Every possible find, sorted by rarity, with the chance in percent.

• Find notification: A clean in-game notification shows the reward and its image right after the door opens.

• Discord log: Every find and every bought door, with the player and the reward.

• Own interface: A custom NUI in the Goliath design. English and German included, every text editable.

Security

• Rewards are rolled on the server, never in the client or the NUI.

• The server checks distance, round time and knock duration before anything is paid out.

• Every door pays out exactly once per round. Double requests are locked.

• Without a command the menu only opens at the door hunter, which the server checks as well.

Compatibility

• Frameworks: ESX Legacy, QBCore, Qbox, custom bridge

• Inventories: ox_inventory, qb-inventory, ps-inventory, lj-inventory, qs-inventory, codem-inventory, tgiann-inventory, origen_inventory, core_inventory, ak47_inventory, jaksam_inventory, chezza_inventory, ESX default, custom bridge

• Interaction: ox_target, qb-target or TextUI with a key

• Vehicles: owned_vehicles on ESX, player_vehicles on QBCore and Qbox

• Requires: ox_lib, oxmysql and OneSync

• Auto setup: framework, inventory and interaction are detected, the table is created on first start

Configuration

• Door hunters with ped, position and map blip

• Optional command to open the menu anywhere

• Round length, knock duration and door distance

• Price and accounts for buying a new door

• Hints with their own unlock times

• Leaderboard size and refresh time

• Rewards with type, amount and chance

• Door locations with photo as a link or as a file inside the resource

For developers

• Hooks: CanOpen, CanClaim, OnFound and your own logging in the editable files.

• Exports: Open (client) and GetFound (server).

Installation

1. Put goliath_doorhunter into your resources folder.

2. Add "ensure goliath_doorhunter" after your framework, inventory, oxmysql and ox_lib.

3. Start the server. The table is created on its own.

4. Adjust the rewards in config.lua to items that exist on your server.

Escrow edition

Protected core through Tebex escrow. Open to edit: config.lua, locales, bridges for frameworks, inventories and targets, client and server editable.lua, sv_config.lua (Discord webhook, server only) and the SQL file. An Open Source edition with the complete source code is available in the Open category.

Support

Questions? The Goliath Scripts support on Discord helps you out. Join the Discord