Lyra Shops · Features

Wholesale

Order stock in bulk, carry crates and restock the store.

Store owners and staff with WholesaleAccess buy stock in bulk from suppliers, then bring it back in crates.

How it works

Open Manage Products → Order Wholesale, or talk to a supplier (they have blips on the map).
Add products to the order and pay with cash or bank.
Go to the pickup point. The order is split into crates (Wholesale.BoxCapacity items per crate).
Carry the crates and load them into your store truck.
Use a crate item to unpack its contents into your inventory, then add them to the store.

Add the crate item

The crate is a usable item named by Wholesale.BoxItemName (default wholesale_crate). Add it to your inventory and copy LyraShops/install/ng_proc_box_01a.png into your inventory's images folder.

ox_inventory/data/items.lua

['wholesale_crate'] = {
    label = 'Wholesale Crate',
    weight = 1,
    stack = true,
    close = true,
},

qb-core/shared/items.lua

['wholesale_crate'] = {
    name = 'wholesale_crate', label = 'Wholesale Crate', weight = 1, type = 'item',
    image = 'ng_proc_box_01a.png', unique = false, useable = true, shouldClose = true, description = ''
},

On ESX without ox_inventory, add wholesale_crate to your items table.

You don't need to write a use handler. The script registers the crate as usable and unpacks it for you.

Options

Option	What it does
`Wholesale.Products`	The catalog: item name, label and price
`Wholesale.Suppliers`	Supplier locations and blips
`Wholesale.BoxCapacity`	Items per crate
`Wholesale.PickupMode` / `PickupFixed`	Where orders are picked up
`Wholesale.UseWaypointForPickup`	Set a waypoint to the pickup
`Wholesale.ImmediateDelivery`	`true` skips crates and gives the items at once (handy for testing)

Higher wholesale levels unlock more products. That list is in shared/level_item.lua.

← Previous

Level system

Weapon stores

Last updated 28 Oct 2026 by Lyra