Custom Shops Pro

One shop and small-business resource that covers every storefront on the map. Drop it in and it auto-detects your framework, target and inventory, then powers everything from a corner store to a job-locked police armory to a dirty-money black market from the same UI.

Performance

• 0.00ms idle
• 0.01ms in the main shop menu
• Briefly 0.02ms while loading management data

Intelligent caching keeps database queries down, and most work stays client-side to reduce callbacks.

Compatibility

Auto-detected on launch:

• Frameworks: ESX, QBCore, Qbox
• Targeting: ox_target, qb-target, q-target
• Libraries: ox_lib

Inventories: ox_inventory, qb-inventory, ps-inventory, lj-inventory, esx_inventory, codem-inventory, origen_inventory, jaksam_inventory, qs-inventory, qs-inventory-pro, tgiann-inventory.

Society banking: qb-banking, esx_society, Renewed-Banking, okokBanking, fd_banking, tgg-banking.

Item label, weight, image and description are pulled automatically from your inventory, and any value can be overridden per item.

Customer-Facing Shop

Responsive UI with grid and list views, real-time search, category filters, product images, stock levels, active sale badges and strike-through pricing on discounted items.

• Preview modal: large images, full description, price breakdown, live stock, add to cart without leaving the preview
• Smart cart: itemized breakdown, quantity editing, automatic subtotals, discounts, final total and savings display
• Payments: cash, bank or society account, with configurable minimum grades and permissions for society purchases
• Coupons: percentage or fixed-amount promo codes redeemed at checkout
• Loyalty: earn points per purchase, redeem for 5%, 10% or 15% discount vouchers
• Cart presets: save, edit, share and import frequent orders
• History and reorder: full purchase log with a one-click reorder
• Licenses: gate products behind a license, the buy button flips to a clear "License Required" message
• Favorites: star products and filter down to only starred items

Shop Types

Each shop keeps its own inventory, pricing, branding and identity, so you can run:

• Convenience stores, hardware stores, pharmacies, specialty stores
• Gun shops with optional weapon serial numbers via metadata
• Job-restricted stores (police armory, EMS supply, mechanic) with multiple allowed jobs per shop
• Black markets that accept dirty money only
• Pawn shops: seller-mode UI with accepted-item filtering, sell value previews and total payout
• Exchange shops: full item-for-item (gold bars for products) or mixed cash and material trades in the same purchase

Any feature (history, loyalty, presets, coupons) can be toggled per shop.

Ownership

Optional player ownership: players buy a shop at a configurable price, manage or sell it, transfer it to another player, or sell it back to the city. Permissions transfer automatically. Ownership can be disabled entirely if you only want NPC stores.

Management Dashboard

Employees and permissions

55+ granular permissions across stock, pricing, coupons, analytics, customer management and sales. Roles have custom profile pictures, and any UI a role can't use is hidden rather than greyed out.

Products

Whitelist-based product setup with custom pricing, custom categories, and job, gang or identifier restrictions. Item metadata is fully supported: durability, quality, grade, custom values, and multiple variants of the same item (for example og_kush and skywalker_og) on both owned and non-owned shops.

Sales

Time-limited percentage discounts scheduled by start and end time, applied at product, category or shop level, and optionally restricted by player, job or gang.

Coupons

Discount value, maximum cap, expiration, minimum purchase, category and product restrictions, total usage limits, per-player limits, automatic resets, and job or gang restrictions.

Customers

Loyalty balance, total spending, purchase count, last visit and full per-customer history. Ban customers when needed, and banned players see a clear access-denied message.

Stock

Order baskets with delivery timers and live countdowns, inventory transfers between shops, capacity limits, and payment via cash, bank or business account.

Loyalty (management side)

Per-shop points-per-dollar rate, tier progression (Bronze, Silver, Gold, Platinum), tier thresholds with permanent discounts, and unlimited custom rewards with name, description, icon, cost and discount value.

Society finances

Deposits and withdrawals, revenue, expenses, net profit, average sale value and transaction counts, all shown in line, area, bar and pie charts. Filter by keyword, type, date, customer, employee or amount.

Shop upgrades

Multi-level upgrade tracks: stock capacity, reputation (supplier discounts), express logistics (faster deliveries), product slots, employee slots and loyalty program.

Analytics

Product sales, coupon effectiveness, customer spending habits, loyalty progression, employee activity logs, hiring and firing history, permission changes, and stock history filtered by employee, item, action or timeframe. Customer and employee names link straight to profile pages.

Shop settings

Shop name, map blip visibility, icon, color and scale, opening hours. Shop names can be locked through config.

Theming

10 built-in presets (deepVoid, slateStorm, midnightBlue, purpleHaze and more), plus configurable primary colors, scrollbar colors, semantic state colors, 40+ tag and badge colors, transaction, employee, category and upgrade card styling, and grid, dots, cross or diagonal backgrounds, all in a single theme.lua.

Logging

25+ logged events with individual toggles, sent to any combination of Discord (formatted embeds), Fivemerr, FiveManage, Grafana or Loki.

Localization

Full locales system, German and English included, add another language in minutes.

Dependencies

• Framework: qb-core, qbx_core or es_extended
• Targeting: ox_target, qb-target or q-target
• Library: ox_lib
• Inventory: any of the auto-detected ones listed above