A lightweight trashcan searching script for RedM/VORP servers. Players can scavenge world trashcan props for random loot, browse and deposit items into a shared per-can inventory, or empty cans entirely. No props are spawned — the script works with trashcan props that already exist in the map.
Overview
Trashcans in towns aren’t just decoration anymore. Players walking within range of a p_streettrashcannbx01x world prop will get hold-to-activate prompts for searching, opening, or emptying the can. Everything runs on a shared, per-can inventory — so what one player takes, another won’t find.
Features
Loot & Interaction
- World prop detection — uses
GetClosestObjectOfTypeto find real map props; no coordinate lists, no prop spawning - Hold-to-search prompt — 1-second hold using JO_Libs native prompts; doubles as the progress indicator
- Search animation — plays a crouch/inspect animation on completion
- Weighted random loot — configurable item table with a
Chancefield per item; adjust weights to shape your drop table - Money rewards — optional cash find alongside or instead of items
- Empty can chance — configurable probability that a search yields nothing
Inventory System
- Shared per-can inventory — each can has its own inventory keyed to its world coordinates; multiple players share the same contents
- Open inventory — hold prompt to browse a can’s current inventory
- Empty can — hold prompt to wipe a can’s inventory
Cooldowns & Resets
- Per-player cooldown — each player’s searched-can list resets independently after
Config.ResetCansTimerminutes; different players are never blocked from the same can by each other - Server-side inventory reset — all shared can inventories are wiped after
Config.ResetInventoryTimerminutes; runs independently of the per-player cooldown
Customization
- Searchable zones — restrict searching to specific towns using
Config.SearchableZones - Static trashcan locations — add any
{ x, y, z }coordinate toConfig.StaticTrashCansto make any spot interactable, even without a prop - Multiple prop support — define additional prop model hashes in config to cover more than the default can
- Discord webhook logging — logs every find to a configurable webhook URL
- Multilingual — English and German included; add your own language file under
languages/
Extending the Map
Want more searchable cans? Use Spooner to place props and export a ymap. A video guide is linked in the README.
LINKS
Download/ Tebex
Support Discord
How It Works
| Action | Input | Result |
|---|---|---|
| Search | Hold (1 s) | Plays animation, rolls loot from item table |
| Open | Hold (1 s) | Opens the can’s shared inventory |
| Empty | Hold (1 s) | Wipes the can’s shared inventory |
Prompts appear automatically when a player comes within ~1 meter of a valid prop or static coordinate. Once searched, a can is locked for that player until their cooldown expires — other players are unaffected.
Installation
- Drop
deliverance_trashcansinto yourresourcesdirectory. - Add
ensure deliverance_trashcanstoserver.cfgafterensure jo_libs. - Restart the server or run
refreshthenensure deliverance_trashcans.
Preview
Pending
Checklist
- I have reviewed the latest version of the Releases rules.
- I have included a detailed description of my work as described in the rules.
- I have included a download link or a store link.
- I have filled out the required information at the end of the topic
| Code is accessible | No |
| Subscription-based | No |
| Lines (approximately) | 86 |
| Requirements | Vorp_Core, JO_Libs, vorp_inventory |
| Support | Yes |
