Custom Shops Pro

A drop-in shop system for FiveM that treats every storefront as a small business, not a menu of items. Owners hire staff, run sales, ship stock orders and read analytics; customers get a modern grid/list UI with cart, coupons, loyalty and reorder.

Auto-detects framework, inventory and targeting on install. Idles at 0.00ms, hits 0.01ms inside the main menu, and briefly touches 0.02ms while management data loads.

Compatibility

Works on ESX, QBCore and Qbox, auto-detected on start.

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.

Targeting: qb-target, q-target, ox_target. Library: ox_lib.

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

Shop Types

Build convenience stores, gun shops, hardware stores, pharmacies, specialty stores or black markets. Each shop keeps its own inventory, pricing, branding and identity. Illegal shops can be configured to accept dirty money only.

Customer-Facing UI

• Grid or list view with real-time search, category filters, stock badges and active-sale strike-through pricing.
• Item preview modal: large image, full description, price breakdown, live totals, add-to-cart without leaving the modal.
• Cart: itemized breakdown, quantity editing, subtotals, discounts, final total, savings display.
• Payment: cash, bank, or society account with minimum grade and permission checks.
• Coupons: percentage or fixed-amount codes redeemed at checkout.
• Loyalty program: points per purchase, discount vouchers (5%, 10%, 15%) and redeemable rewards.
• Cart presets: save, edit, delete, share and import frequent orders.
• Transaction history: full list with one-click reorder to recreate any past purchase.
• Favorites filter and a License Required state that swaps the buy button when the player lacks the license.

Special Shop Modes

• Pawn shop: seller-mode UI with accepted-item filtering, sell-value preview and payout totals.
• Item-for-item exchanges: gold bars for products, or mixed carts that deduct cash and materials in the same transaction.
• Job-restricted shops: police armories, EMS supply rooms, mechanic stores, with multiple allowed jobs per shop.
• Per-shop feature toggles for history, loyalty, presets and coupons so specialty stores can strip back the UI.
• Optional weapon serial registration written to metadata.

Ownership & Management

Players can buy, manage, transfer and sell shops back to the city, with configurable purchase prices and automatic permission transfer. The whole ownership layer can be turned off.

Products & Pricing

Whitelist products with custom prices, categories, job/gang restrictions and identifier locks. Support for item metadata means multiple variants of one item (og_kush, skywalker_og) sit side by side, with durability, quality or grade values on both owned and non-owned shops.

Sales & Coupons

Schedule product, category or shop-wide sales with start/end times, restricted to specific players, jobs or gangs. Coupons carry expiration dates, minimum purchases, category/product limits, usage caps, per-player limits, automatic resets and job/gang restrictions.

Customers

Track loyalty balances, total spend, purchase counts, last visit and full purchase history per player. Ban customers to hit them with an access-denied screen on entry.

Employees & Permissions

55+ granular permissions across stock, pricing, coupons, analytics, customer management and sales, with role-based visibility so unavailable panels stay hidden. Custom profile pictures per employee.

Stock Orders

Order baskets with delivery timers, live countdowns and capacity limits. Pay for orders in cash, bank or business account, transfer inventory between shops, and cap total capacity per shop.

Loyalty (Owner Side)

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

Finances & Analytics

Deposits and withdrawals on the society account. Revenue, expenses, net profit, average sale value and transaction counts rendered as line, area, bar and pie charts. Filter by keyword, type, date, customer, employee and amount.

Upgrades

Multi-level upgrades for stock capacity, reputation (supplier discounts), express logistics (faster deliveries), product slots, employee slots and unlocking the loyalty program.

Reporting

• Product analytics: quantities sold, revenue, average sale, last sold date.
• Promotion analytics: coupon effectiveness, discount performance, customer savings, revenue impact.
• Customer insights: spending habits, loyalty progression, purchase trends.
• Employee tracking: activity logs, hiring/firing history, permission changes.
• Stock history filterable by employee, item, action and timeframe. Customer and employee names link to detailed profile pages.

Shop Settings

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

Theming

One theme.lua controls everything. Ten built-in presets (deepVoid, slateStorm, midnightBlue, purpleHaze and more) plus primary colors, scrollbar colors, semantic state colors, 40+ tag and badge colors, transaction/employee/category/upgrade card styling, and grid, dots, cross or diagonal backgrounds.

Logging

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

Localization

Full locales system, German and English included, additional languages take minutes to add.

Dependencies

Framework (one of): qb-core, qbx_core, es_extended.

Targeting (one of): qb-target, q-target, ox_target.

Library: ox_lib.

Inventory: auto-detected from the list above.

More features are planned for future updates.