Dumpster Diving — Configuration

Four files, all unencrypted: config/config.lua, config/loot.lua, config/recycler.lua and config/perks.lua.

Searching

Key	Default	What it does
duration	7000	Search time in ms, before any perk speed bonus
maxDistance	4.0	How far you can drift from the bin before it cancels
cooldown	3	Minutes a bin stays picked clean — shared by everyone
playerCooldown	8	Seconds between successful searches, per player
rateLimit	2	Seconds between search attempts
minMove	0.8	Metres you must move between searches

Hourly limits

Key	Default	What it does
searchesPerHour	120	Hard ceiling on searches per player per hour
cashPerHour	15000	Hard ceiling on recycler payout per player per hour

Both are enforced server-side. They exist so an idle player farming all night can't outpace a real job — raise or remove them if that isn't a concern on your server.

Loot

config/loot.lua holds the roll table. Each entry is an item, a weight and a quantity range. Most bins give scrap; valuables sit at a much lower weight.

Any item you add here must exist in your inventory — there is no fallback for an undefined item name.

Recycler

config/recycler.lua sets the ped, its location and blip, and the price per item.

ped   = { model = 's_m_y_garbage', coords = vec4(-336.0, -1554.5, 25.2, 210.0) },
blip  = { enabled = true, sprite = 318, colour = 15, label = 'Recycling Centre' },
prices = { rolex = 900, goldchain = 600, ... }

Prices here are the other half of the economy. An item with no price cannot be sold.

Police alerts

Key	Default	What it does
enabled	true	Master toggle
chance	6	% chance per search that a passer-by calls it in

The odds rise when something valuable comes out. Perks reduce them — see below.

Perk levers

With jj-perks running, the dumpsterdiving category drives four per-level bonuses:

Lever	Per level	At level 10
speedPerLevel	2.5%	25% faster searching
rarePerLevel	6.0%	+60% rare-find odds
payoutPerLevel	2.5%	+25% recycler payout
heatPerLevel	4.0%	40% less chance of being reported

extraRolls grants additional loot rolls per bin at set levels. XP is awarded per search, per find, and generously for a rare pull.

Set Perks.enabled = false to ignore jj-perks entirely even if it is running.

Debug

Config.debug = true prints loot rolls and cooldown keys to the server console. Useful when tuning loot.lua; leave it off in production.

Next: Troubleshooting.