qb-recyclejob

qb-recyclejob is a warehouse loop. The player carries boxes to a drop point, receives crafting materials, and can sell those materials back to an NPC at a fixed price list. It is the usual source of metalscrap, plastic, copper, iron, aluminum, steel, and glass on a stock server.

It pairs naturally with qb-scrapyard, which produces the same material set from scrapping vehicles.

The manifest at the commit linked above declares version 2.2.0.

Dependencies and start order

From the manifest: @qb-core/shared/locale.lua and locales as shared scripts, then PolyZone client.lua, BoxZone.lua, CircleZone.lua, plus client.lua and server.lua.

From the implementation: qb-core, qb-inventory for the item box, qb-log for the ban log line, and a MySQL layer for the ban insert.

Start order: oxmysql, qb-core, qb-inventory, PolyZone, then qb-recyclejob.

Configuration

config.lua is a single table literal.

PickupActionDuration and each model field use math.random at file load. They are fixed for the lifetime of the resource, not rolled per action. Restart the resource to reshuffle them.

Stock and pricing

Stock and the price list live in server.lua, not in config.lua. At this commit each material starts at 3000 units. Selling a material returns it to stock, and taking one removes it, so a busy server drains and refills the same pool.

With LimitedMaterials = false, stock is ignored entirely and materials are unlimited.

To retune the economy, edit the Sales and stock tables in server.lua. Editing config.lua will not change prices.

Server surface

Distance checks and escalation

Both money and item paths go through one helper:

local function isClose(source, loc)
    -- reads the ped position on the server
    -- 'turnIn' compares against the drop location
    -- 'sell' compares against the sell location
    -- returns true under 5.0 units
end

Position is read on the server, which is the right approach. On failure the helper increments a per-citizen counter and permanently bans at three strikes, writing to the bans table with bannedby = 'qb-recyclejob' and expire = 2147483647.

Two caveats:

• The bans table is not created by this resource. Confirm it exists with the columns name, license, discord, ip, reason, expire, bannedby before enabling.
• The counter in isClose uses uhohs[cid] = uhohs[cid] + 1 or 0, which errors on the first failure for a citizen with no existing entry, because the addition is evaluated before the or. The getItem handler works around this with its own nil check, the sell path does not.

sellItem takes amount from the client but clamps it: the helper reduces amount to what the player actually holds before pricing, and the price itself comes from the server-side table. A forged amount therefore cannot inflate the payout.

Troubleshooting

Proposed manual smoke test

Not yet executed. On staging, with a database backup:

1. Confirm the bans table exists before starting.
2. Run one full loop: pick up a box, turn it in, confirm materials arrive.
3. Sell materials at the NPC and confirm cash matches the server-side price list.
4. Attempt to sell from outside 5 units and record whether a ban or an error results.
5. Set LimitedMaterials = false and confirm stock is ignored.
6. Clear any test bans afterwards.

Sources

• fxmanifest.lua 
• config.lua 
• server.lua