About
Description
Code9 Shop is a professional, fully configurable shop system for FiveM. It features a modern React-based UI, a complete admin panel with in-game shop creation, multi-location support, stock management, dynamic theming, Discord webhook integration, and shop import from other popular scripts — all without touching code.
Key Features
Admin Panel
- Full in-game admin panel with dashboard, product management, category system, location manager, and theme editor
- Create and manage unlimited shops with the
/createshopcommand - Admin permission via ACE, job, group, or license-based authentication
Product Management
- Add, edit, and delete products with price, category, image, description, and stock
- Import from Inventory: Browse all server items directly from admin panel and import with one click
- Bulk Import: Import products from JSON format
- Per-item job and grade requirements — restricted items appear grayed out in the UI
Multi-Location System
- Each shop supports unlimited physical locations with independent peds, blips, and interaction distances
- GTA V map view using Leaflet for visual location management
- 3D coordinate picker with raycast visualization for precise placement
- Interactive ped placer with real-time position and rotation controls
Stock Management
- Per-item stock tracking with automatic deduction on purchase
- Optional auto-restock with configurable interval
- Stock count displayed on item cards in the shop UI
Theme System
- 5 built-in presets (green, red, blue, yellow, dark) + custom color picker
- Per-shop theming — each shop can have its own look
- Live preview in the admin panel
Webhook System
- Discord webhook integration with color-coded embed messages
- Per-event toggles: purchases, shop/product/category/location CRUD operations
- Configurable per shop
Shop Import
- Import shops from other scripts: QB Market, ESX Market, ox_shop, or Custom JSON
- Auto-detects format and normalizes data — supports both JSON and Lua table syntax
Interaction System
- Built-in E key interaction with configurable distance
- Support for
qb-targetandox-target - Per-location interaction distance override (priority: location > shop > global config)
Multi-Framework & Multi-Inventory
- Frameworks: ESX, QBCore, QBox, Standalone (auto-detected)
- Inventories: ox_inventory, qb-inventory, ps-inventory, qs-inventory, codem-inventory, gfx-inventory, esx_inventoryhud (auto-detected)
- Databases: oxmysql, mysql-async, ghmattimysql (auto-detected)
- Notifications: Framework default, codem-notification, okokNotify, mythic, 17mov
Performance
- Single-thread interaction manager for all shops
- Squared distance calculations and streaming distance filtering
- Optimized NUI communication with throttled messages
