W-Labs Shop Script is a lightweight, secure, and fully configurable shop system for Qbox/QBCore servers. It gives players a modern cart-based shopping experience with support for Cash/Bank payments, dynamic pricing, as well as inventory handling for full pockets.
Key Features
-
Cart-Based Shopping UI
- Players can add multiple items to a cart, adjust quantities, and then checkout using cash/bank.
- Configure a global UI color, or have a different color for each shop type.
-
Dynamic Pricing (Per Restart)
- Support for price ranges (e.g.
{ min = 5, max = 15 }). - Prices are rolled once on server start, allowing subtle economic variation without manual edits.
- Support for price ranges (e.g.
-
Clean ox_target Integration
- Each shop location is an
ox_targetentity with:- Custom ped models and scenarios (drinking, clipboard, smoking, etc.).
- Configurable interaction distance and target zones.
- Just walk up to a shopkeeper, target, and open the shop.
- Each shop location is an
-
Smart Blip System
- Config option to show all blips for every location, or only the nearest location per shop to reduce map clutter.
- Blips use per-shop sprites, colors, scales, and dynamically update to follow the closest target when
showAllBlipsis disabled.
-
Inventory Overflow Handling
- Configurable
Config.overflowdrop:-
true: items that don’t fit are automatically dropped on the ground as an
ox_inventorycustom drop. - false: purchase is denied if the player cannot carry all items.
-
true: items that don’t fit are automatically dropped on the ground as an
- Robust server-side logic to ensure players are always charged correctly and never lose money due to inventory issues.
- Configurable
-
Banking Integration (Optional)
- If
tgg-bankingis running, bank purchases are logged as proper transactions with:- Shop label
- Item count
- If
Requirements
-
Framework
- Qbox / QBCore (uses
exports.qbx_core:GetPlayerandplayer.Functions.*)
- Qbox / QBCore (uses
-
Dependencies
-
ox_lib -
ox_inventory -
ox_target
-
-
Optional
-
tgg-bankingfor detailed bank transaction logs on card purchases
-
