> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_ecommerce.md). # ak47\_ecommerce The ultimate multi-vendor player marketplace and ecommerce experience for FiveM servers. {% embed url="" %} Empower your server's economy with a complete online shopping platform allowing players to register stores, list items from their inventory, and manage sales. Features an ultra-clean, modern React tablet UI, in-store physical pickup, doorstep delivery with cash-on-delivery payments, employee permission management, and comprehensive admin controls. Fully integrated with `ak47_lib` for effortless standalone compatibility across ESX, QBCore, and QBX frameworks. *** ### 🔥 Key Features Designed to improve roleplay immersion and economy balancing: #### 🛒 Multi-Vendor Marketplace & Player Stores * **Shop Registration & Admin Approval:** Players can apply to register their own brand or storefront with a custom name and physical location for a configurable registration fee. Applications are held pending until approved or denied by administrators. * **Storefront Blips & Automatic Street Detection:** Vendors can set physical storefront coordinates with automatic street/zone name resolution and toggle optional public map blips for customers. * **Modern Tablet NUI Interface:** Built with React, Tailwind CSS, and Vite, opening seamlessly via `/market` with realistic player tablet-holding props and synchronized animations. #### 📦 Seamless Shopping & Flexible Order Delivery * **Interactive Marketplace & Cart:** Customers can explore all approved vendors, browse items by custom categories, search products, and add items from multiple vendors into their shopping cart. * **In-Store Pickup Option:** Customers can place orders for in-store pickup, set automatic GPS waypoints directly to the vendor's storefront, and collect their goods using 3D markers and TextUI prompts. * **Cash on Delivery (Doorstep Delivery):** Vendors or employees can deliver orders directly to the customer's live position, with phone number exchange, automatic routing, and proximity cash/bank collection upon handover. * **Customer Order Hub & Relocation:** The "My Orders" tab lets customers track pending, out-for-delivery, and completed orders, cancel active orders, or dynamically update their delivery address on the fly. #### 💼 Vendor Analytics & Employee Management * **Sales Analytics Dashboard:** Dedicated vendor dashboard displaying total earnings, order counts, items sold, and recent order logs, paired with a one-click shop balance withdrawal system. * **Stock & Listing Management:** Easily list items directly from inventory, adjust product pricing in real time, add or remove stock, or unlist products to return items safely to your inventory. * **Employee Staffing & Granular Permissions:** Hire nearby players via Server ID with an interactive accept/reject prompt. Control individual staff permissions for managing products, managing orders, managing employees, withdrawing funds, and editing shop details. #### 🛡️ Global Admin Management & Control * **Shop Moderation:** Dedicated admin interface to review pending shop requests (with automatic fee refunds upon denial), disable problematic shops, re-enable shops, or permanently delete stores. * **Global Product Moderation:** Real-time visibility into all active product listings across the entire server with the ability to delete rule-breaking items. * **Dynamic Category Management:** Create new product categories on the fly or safely delete existing categories with automatic validation preventing removal if in active use. #### 🛠️ Technical Excellence * **Multi-Framework & Target Support:** Seamlessly works with ESX, QB, QBX, and various target systems (ox\_target, qb-target, qtarget). * **Highly Secure:** Built-in server-side exploit checks, including distance validation and trigger authentication, to prevent cheating. * **Automatic Database & Asset Setup:** Automated table generation (`CREATE TABLE IF NOT EXISTS`), automatic order cleanup routines, and automatic inventory image resolution via `ak47_lib`. *** ### 💻 Framework: * ESX, QB, QBX *** ### ⚙️ Dependencies: * ak47\_lib: *** ### ⚙️ How To Install: * Download ak47\_ecommerce from your cfx portal. * Add the script in your resources folder. * Add items based on your framework instruction. * Add item images into inventory. * Start the script in your server.cfg below framework files. * Make sure you have all dependencies. * Restart the server. *** ### 🔗 Links & Support: * **📖 Documentation:** * **🛒 Buy Now (Tebex):** * **💬 Discord Support:** *** ### 📝 Note: * We don't support custom framework. Make sure you are using official framework update. * Renaming the script is not allowed. It may break the functionalities. * Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading