RedM Supply Drop & Scavenger Hunt Script Poggy's Supply Drops

A RedM supply drop and scavenger hunt script: crates float down under a hot air balloon at one of 10 locations, and 30 ready-made treasure hunts send players after a photo and a riddle. It runs on VORP Core, RSG Core and QBCore RedM, starts events on its own schedule, and posts them to Discord.

What players get

Supply drops

• A drop starts at a random location. Every player gets a notification and a map blip.
• Players close by watch the balloon come down. Players far away find the crate already landed.
• The first player to hold G at the crate claims it. Loot is picked by weight, and weapons can be in the table.
• An unclaimed drop disappears after 15 minutes.

Scavenger hunts

• A hunt hides a treasure somewhere in the world. Every player gets a notification and a map blip.
• /clue opens the hunt window: a photo of the hiding place, the reward and a blurred riddle.
• Revealing the riddle lowers the reward, by 30% by default.
• The first player to hold G at the treasure claims it. Rewards are cash, gold or items.
• An unclaimed hunt disappears after 45 minutes.

What owners and staff get

• An automatic schedule for each event. By default a new drop comes about every 70 to 135 minutes and a new hunt about every 110 to 210 minutes.
• Nothing starts until the first player has loaded in.
• Admin commands to start a drop or a hunt at any time. Admins are your framework's admin groups, read by poggy_core.
• Two Discord webhooks, one for drops and one for hunts: new events, who collected a drop, and who found a treasure, with or without the clue.
• Five colour themes for the hunt window: Crimson, Twilight, Oceanic, Forest and Monochrome.
• English, Spanish and French messages.
• Every setting in game under /poggy, with help pages for the schedule, adding drop locations and loot, and adding scavenger hunts.

Commands

Settings you will change first

• Config.Supply.ItemDrops: the drop loot. Every item name must exist on your server.
• Config.Scavenger.RewardTypes: hunt rewards, as cash, gold or items.
• Config.RandomEvent: cooldowns and waits, in milliseconds (60000 is one minute).
• Config.Scavenger.UI.CluePenalty: what revealing the riddle costs (0.3 by default).
• Config.Discord: the two webhook URLs.
• Config.Scavenger.Theme and Config.Language.

To add a hunt, stand at the hiding place, add it in /poggy with "use my position", and put its photo in ui/images/ as a .jpg.

What you need to run it

• VORP Core, RSG Core or QBCore RedM, through the free poggy_core 0.28.0 or newer.
• No other resources, no database tables and no SQL to import.
• Open files: config.lua, translations.lua and the whole hunt window (ui/ HTML, CSS, JavaScript and photos). The rest of the Lua is protected by Cfx escrow.

Event ideas that use it are in RedM server event ideas.

Updates

poggy_core checks for new versions, installs them and merges your config and translations: new settings arrive with their defaults and your values stay.