ds-dumpsterdiving

# 🗑️ DS Dumpster Diving Script

A fun and fully configurable dumpster diving script for **FiveM** 

that supports **QB-Core**, **ESX**, multiple inventories, progress bars, and per-dumpster cooldowns!  

Players can search dumpsters, find random items, and enjoy immersive animations with multi-target and multi-notify support.

# ⚙️ Features

- ✅ Supports **QB-Core** & **ESX**

- ✅ Multiple inventory systems:

  - `qb`,`ox`,`ps`,`lj`,`qs`,`codem`,

`mf`,`origen`,`core`,`esx`,`custom`,`fallback for qb`

- ✅ Random loot system with configurable chances and amounts

- ✅ Per-dumpster cooldowns & reuse delays

- ✅ Progress bar support:

  - `ox_lib`, `ps-ui`, `qb-progress`, or fallback

- ✅ Multi-target support:

  - `qb-target`, `ox_target`, or fallback 3D text

- ✅ Multi-notify support:

  - `qb`, `okokNotify`, `ox_lib`, `ps-ui`, `custom`

- ✅ Animations during dumpster search

- ✅ Configurable messages & notifications

# 🎮 Installation

Place the resource in your resources folder, e.g., resources/[QB/ESX]/ds-dumpsterdiving.

Add to your server.cfg:

ensure ds-dumpsterdiving

Restart your server.

# 📌 Usage

Approach a dumpster and interact using:

QB-Target / OX-Target, or

[E] key fallback

Search the dumpster, watch the progress bar, and receive random loot.

Each dumpster has its own cooldown — you can search multiple dumpsters independently!

# 🧩 Recommended Optional Addons

ox_lib for progress bars and notifications

ps-ui for circle progress bars

okokNotify for notifications

qb-target / ox_target for target interactions

# 🔧 Notes

Make sure to configure your inventory and target systems correctly in config.lua.

Random loot chances are fully configurable per item.

Cooldowns are per dumpster, so multiple dumpsters can be searched separately.

Animations during search enhance immersion.

# 🤝 Support

Tested with QB-Core and ESX.

Multi-inventory support included.

Fully compatible with other resources as long as they don’t conflict with dumpster targets.