QQ Market

📊 A real economy engine — players set the prices, not your config

Most FiveM "economies" are nominal: NPC shops with fixed, admin-set prices. QQ Market is a real economy engine — a live order book where every price is discovered by players posting buy and sell orders that match on supply and demand. Nobody prices a weapon or a sandwich; the market does. Scarcity, surplus, hype and speculation become real numbers on a real bid/ask spread.

It's the idea that made EVE Online's player-run economy legendary — regional markets, arbitrage, speculation — brought to FiveM as order books, spreads, market depth and multiple market locations whose prices can genuinely diverge. (Inspired by that model — not a claim of feature parity.)

🚀 What it unlocks on your server

• Trading as a playstyle — buy low at the Docks, sell high in Sandy Shores; a trader career with no scripting.
• Arbitrage between markets — global / isolated / hybrid modes create regional price gaps.
• Black markets — an isolated market becomes a separate, illicit economy for weapons or drugs.
• Player-run markets — players place their own market with a license item and earn fees.
• A real money sink — configurable market and withdrawal fees give you a genuine lever against inflation.

✨ Features

Order-book trading

• Limit buy and sell orders with automatic price-time (FIFO) matching
• Partial fills across multiple counter-orders
• Price improvement — a buyer matched against a cheaper ask is refunded the difference
• Direct trading — buy from a listing or sell straight into a standing bid
• Quick-sell your warehouse into existing demand

Warehouse and market wallet

• Personal item warehouse (deposit from / withdraw to inventory)
• Market wallet — deposit cash to trade, withdraw your proceeds
• Configurable market fee and optional withdrawal fee

Multi-market system

• Place markets anywhere (NPC or prop) with map blips
• Three modes: Global (shared book), Isolated (separate economy / black market), Hybrid
• Player-owned markets — players place their own market with a license item
• Live admin control of mode and on/off (no restart)

Modern web UI

• Four views: Marketplace, Order Book, Warehouse, Player Orders
• Dark trading-desk theme, search, color-coded buy/sell
• 7 languages: EN, FR, ES, DE, PL, RU, UK

Built to be safe

• Server-side validation of every trade (quantity, price, item, market)
• Atomic, race-safe balances and stock — no negative balances, no double-fills
• Parameterized SQL throughout
• Discord webhook logging of trades and admin actions

Configurable and operator-friendly

• Tune everything in one config.lua: limits, fees, money source (cash/bank), interaction key, accent color, markets and items
• No runtime CDN — jQuery and Font Awesome bundled (offline / firewall / strict-CSP safe)
• Rename-safe — rename the resource folder and the UI still works
• Every server and UI string localized across all 7 languages

🧩 Requirements

• Framework: QBCore, Qbox (qbx_core), or ESX — auto-detected on start
• ox_lib, oxmysql, ox_inventory (all free)
• Optional: MugShotBase64 (character photos)

📦 Specs

• Code: escrow-protected. config.lua, locales and the entire web UI stay open and editable.
• Database: oxmysql (tables auto-create on first start; install.sql included)
• Languages: 7 (server + UI)

🛠️ Support and updates

• Lifetime updates for licensed buyers
• Support via Tebex ticket and the Cfx.re release topic

Single-server license. Redistribution, resale, or modification for resale is prohibited.