# ak47\_supermarket {% embed url="" %} ### Features: #### 🏪 Core Shop Management * Dynamic Shop Ownership: Players can purchase, own, and manage physical storefronts across the map. * Infrastructure Upgrades: A tiered progression system allowing owners to invest shop funds to increase stock capacity and delivery vehicle limits. * Customizable Shop Settings: Owners can toggle specific features such as infinite stock (for server-run shops), auto-checkout, and active delivery locations. * Physical Item Displays: A slot management system that allows owners to define exactly which items are displayed at specific physical locations inside the store. #### 🛒 Advanced Point of Sale (POS) & Checkout * Interactive POS Terminal: A fully featured interface for cashiers to process transactions, calculate cash change, and simulate card insertions. * Barcode Scanner UI: An immersive checkout phase where cashiers or customers drag and drop items over a virtual scanner. * Flexible Billing: Employees can manually construct custom bills for customers from the available shop inventory. * Customer Shopping Carts: Players can browse the physical store, add items to a local cart, and view their total bill before checking out. #### 📦 Logistics & Inventory Control * Immersive Supply Deliveries: Physical shipment missions requiring players to drive delivery vehicles, unload cargo using trolleys or boxes, and track progress. * Dynamic Pricing System: Shop owners can adjust retail prices for their products within administratively defined minimum and maximum limits. * Real-time Stock Management: Interfaces for quick stock adjustments, adding or removing catalog products, and ordering new shipments based on vehicle capacity. #### 🚶 AI Customer Integration (NPCs) * Living Storefronts: AI customers physically spawn, navigate into the shop, and browse items based on custom pathing. * Passive Income Generation: NPCs purchase items directly from the stock, generating revenue and issuing bills to the shop's account automatically. * Queue Management: Configurable waiting lines for NPCs to simulate a realistic retail environment. #### 👥 Employee & Financial Operations * Staff Management: Owners can hire and fire employees, assign specific access permissions (e.g., manager vs. cashier), and set custom salaries. * Automated Payroll: The server handles automatic paycheck disbursements to employees on a configured interval. * Corporate Accounts: Dedicated shop bank accounts where owners can view balances, deposit personal funds, or withdraw profits. #### 🛠️ Administrative & Builder Tools * In-Game 3D Shop Builder: A comprehensive tool with a freecam and raycasting for admins to physically draw shop zones, place signs, map NPC paths, and designate garage areas. * Global Item Database: An admin panel to categorize items, set universal minimum/maximum prices, and control server-wide economy constraints. * Integrated Door Locks: A raycast-driven UI to easily select door models and lock them to specific shop permissions. ### Framework: * ESX, QB, QBX ### Dependencies: * ak47\_lib: * PolyZone: * ox\_target/qb-target/qtarget ### How To Install: 1. Download `ak47_supermarket` from your cfx portal. 2. Add the script in your resources folder. 3. Import `database.sql` in your server database. 4. Start the script in your `server.cfg` below framework files. 5. Make sure you have all dependencies. 6. Restart the server. ### Buy & Support: * Tebex: * Discord: ### 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.menanak47.com/multi-framework/ak47_supermarket.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.