Turn the dumpsters, street bins, and scrap skips already on the map into a scavenging loop. No custom props, no extra map. Players search what is already there, and the server decides what they walk away with.
Scavenging
- Three container types: large dumpsters, street trash bins, and industrial scrap skips
- 37 vanilla GTA props, each with its own label, icon, animation, search time, and cooldown
- Weighted loot table with an empty chance, drop rates, and minimum / maximum amounts
- Add, remove, or retune any item from the config. An empty list gives nothing
- Cash is paid as an item, or through the framework if the inventory cannot take it
- A full inventory warns the player and skips what they cannot carry
- Once a container is searched, nobody can search that same one until the cooldown ends
Gloves and injury
- Searching without gloves can cut the player on broken glass or rusty scrap
- Work gloves grant full immunity. The check is done on the server, from the real inventory
- At critical health there is a small chance the injury is fatal
- Damage does not leave blood. The system can be turned off
Security
- Loot is rolled only on the server
- A reward needs a valid session token and the full search time
- Distance is checked when the search starts and again when the reward is claimed
- Cannot search from a vehicle, while downed, or during another search
- Walking away, entering a vehicle, or going down cancels it
- Cancel with X or ESC
- Spam protection between searches, with sessions cleared on disconnect
Interaction and UI
- ox_target and qb-target are detected automatically
- With no target script, players get 3D text and the E key
- Built-in progress bar with a live percentage, or ox_lib
- Notifications through the framework, ox_lib, or the built-in HUD
- Separate sounds for a find, a warning, and an injury. No audio files, and sound can be disabled
Compatibility
- QBCore, Qbox, ESX, and Standalone
- ox_inventory, qb-inventory, qs-inventory, and ESX inventory
- English and Turkish included. Add another language with a JSON file
- Framework, inventory, and target are set to auto, or pick one yourself
Included
- Open config, locales, bridges, and UI
- Ready-to-paste item definitions for ox, qb, and qs, plus an ESX SQL import
- Transparent item icons for Work Gloves and Broken Glass
Documentation
