# ak47\_supermarket

{% embed url="<https://youtu.be/4ZXqnkbEh-0>" %}

### 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: <https://github.com/MenanAk47/ak47_lib/releases/latest>
* PolyZone: <https://github.com/mkafrin/PolyZone/releases/latest>
* 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: <https://menanak47.tebex.io/package/7315664>
* Discord: <https://discord.gg/menanak47>

### 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.