Scripts / PRP TrashHunt

prp-trashhuntv1.3.0Scavenging

PRP TrashHunt

Dumpsters, bins and back alleys become a scavenging loop. Players look into the container, grab what they can in a short mini-game, then open the haul like a card pack.

FreeRun it on any number of servers. Resale and re-uploads are not allowed.

Delivered through your Cfx Portal. Needs ox_lib, a framework, and ox_target or qb-target.

The round summary from 1.3. Score, a trace of every grab, and the haul as cards.

Gameplay

A loop players run on their own or between jobs. Search, grab, reveal, level up, craft. Every container type has its own loot, noise and risk.

Loot cards using item art from the server's own inventory images

The haul, dealt as cards

After each search the loot is dealt as Common, Rare and Ultra cards. The art comes from your inventory's own image folder, detected for ox, qb, ps and lj inventories, with bundled icons as a fallback. Sound effects are generated in the browser, so there are no audio files to install.

Look in, grab fast

First-person interiors for dumpsters, bins, bags, recycle bins and skips. The mini-game score sets the loot tier.

Six container types

Dumpster, trash can, trash bin, trash bag, recycle bin and industrial skip, each with its own loot pool.

Rep and licenses

Fifteen rep levels, from Scrapper to Legend. Salvage licenses unlock crafting recipes as players level.

Recycling and disposal

Process materials at recycle bins and skips. Unwanted items turn into scrap metal and a little rep.

Hot zones

Areas that switch on at set times with better loot and higher hazards. Add your own in the config.

Hazards

Noise, cuts that can infect, and an optional hook that tells your zombie script when a search gets loud.

Compatibility

Framework, inventory, target and database are detected at startup. Each one can also be set by hand in config/config.lua.

Required
ox_lib; Qbox, QBCore or ESX; ox_target or qb-target.
Inventories
ox_inventory recommended. qb-inventory on Qbox and QBCore, and the default ESX inventory, are supported.
Database
Optional. On Qbox, rep is stored in player metadata. oxmysql is only needed if you want rep in its own table.
Crafting
Built-in recipes, plus an example recipe export for okokCrafting.
Languages
English, German, Spanish, French, Brazilian Portuguese and Turkish.
Notifications
ox_lib, QBCore or ESX.
Tested
Live on our server with Qbox, ox_inventory and ox_target. The QBCore and ESX adapters are included but have not run on our server.
Check items
Run trashhunt_item_audit in the server console to confirm every configured item exists in your inventory.

Configuration

The config, locales, core logic and framework adapters ship unencrypted. The free license lets you change them for your own server.

What you can change

Loot
Containers, loot pools, rarity and item names.
Progression
Rep thresholds, the hourly rep cap, licenses and crafting gates.
Pacing
Search time, cooldowns and diminishing returns on chain-looting.
Risk
Noise, hazards, infection chance, hot zones and per-job modifiers.
Logging
Console output and an optional Discord webhook.

What the server checks

Loot
Rolled on the server. The client never says what it found.
Searches
Pay out only with a server-issued token, after checks on container type, distance and cooldowns.
Scores
A missing mini-game score never counts as a perfect run.
Usage ping
On start and every 12 hours the script can send its version, a random install id, adapter modes and player count. No player identifiers, and never a license check. Turn it off with Config.UsagePing.Enabled = false.

Updates

Current version 1.3.0, The Haul Update, released November 2026.

  1. 1.3.0, The Haul Update

    Card-pack loot reveal, one HUD pill for container, time, score and streak, a run trace of every grab, and built-in sound. Loot tables and server checks unchanged.

  2. 1.2.0

    Looking-in interiors for every container. Servers running only qb-target no longer hang. BCSO and SASP get the same job bonus as police.

  3. 1.1.0

    Now free. Scoring and rewards hardened on the server.

Full changelog

Support

Help with install, configuration and bugs in this script.

Delivery

Claim it on Tebex and it appears in your Cfx Portal, ready to download.

Where to ask

Open a Discord ticket with your framework, inventory and the full console error.

Response target

We aim to reply within two business days.

License

Pursuit Scripts Free License. Any number of servers, no resale or re-uploads.

Common questions

Short answers. The docs have the detail.

Is PRP TrashHunt really free?

Yes. Claim it on Tebex and run it on as many servers as you like. You can change it for your own server, but you cannot resell it or upload it to another store.

Does it work on QBCore or ESX?

Yes. Adapters for Qbox, QBCore and ESX are included and picked automatically. We run it live on Qbox. The QBCore and ESX adapters have not run on our server, so if something misbehaves, send us the console output.

Do I need ox_inventory?

No. ox_inventory is recommended, and qb-inventory and the default ESX inventory are supported. You do need ox_lib and either ox_target or qb-target.

Does it need a database?

No. On Qbox, rep is stored in player metadata. oxmysql is only needed if you want rep stored in its own table.

Can players farm it?

Loot is rolled on the server, and every search needs a server-issued token plus checks on container type, distance and cooldowns. Chain-looting has diminishing returns, and rep has an hourly cap you can set.

Does it send any data?

It can send an anonymous usage ping on start and every 12 hours: script version, a random install id, adapter modes and player count. No player identifiers, and it never stops the script. Set Config.UsagePing.Enabled = false to turn it off.