> For the complete documentation index, see [llms.txt](https://rambo3dev.gitbook.io/rambo3dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rambo3dev.gitbook.io/rambo3dev/rambo3dev-shops-creator/shops-creator-overview/player-shopping-experience.md).

# Player Shopping Experience

**Everything players need to know about using shops**

***

### 🎮 Player Shopping Overview

The Rambo3Dev Shops Creator provides an intuitive and immersive shopping experience for all players. This guide covers everything customers need to know about using the shop system.

#### 🗺️ Finding Shops

Shops are easily identifiable on your map and in the world:

| Indicator               | Description                          |
| ----------------------- | ------------------------------------ |
| **Map Blips**           | Colored icons showing shop locations |
| **Shop Peds**           | NPCs standing at shop entrances      |
| **Interaction Prompts** | On-screen prompts when nearby        |
| **Shop Names**          | Displayed above shop entrances       |

#### 🎯 Shop Interaction

<figure><img src="/files/MAM8CcYD8h5qSDWQn6tT" alt=""><figcaption></figcaption></figure>

**How to interact with shops:**

1. **Approach the shop NPC** - Walk within 3 meters of the shop keeper
2. **Look for interaction prompt** - "\[E] Open Shop" will appear on screen
3. **Press the interaction key** - Default is 'E' to open the shop interface
4. **Shop interface opens** - Modern UI with all available items

**Shop Interaction Features:**

* **Automatic detection** - No need to target specific areas
* **Clear prompts** - Easy-to-see interaction indicators
* **Smooth transitions** - Seamless opening of shop interface
* **Multiple shop types** - Each with unique NPCs and locations

***

### 🏪 Shop Types & Locations

#### Available Shop Categories

| Shop Type             | Icon                                                                          | What You'll Find                  |
| --------------------- | ----------------------------------------------------------------------------- | --------------------------------- |
| 🏪 **General Store**  | ![General](https://via.placeholder.com/20x20/52a3cc/fff?text=%F0%9F%8F%AA)    | Food, drinks, basic supplies      |
| 🔫 **Weapon Shop**    | ![Weapon](https://via.placeholder.com/20x20/cc5252/fff?text=%F0%9F%94%AB)     | Firearms, ammunition, accessories |
| 👕 **Clothing Store** | ![Clothing](https://via.placeholder.com/20x20/52cc52/fff?text=%F0%9F%91%95)   | Outfits, accessories, shoes       |
| 🔧 **Hardware Store** | ![Hardware](https://via.placeholder.com/20x20/cccc52/fff?text=%F0%9F%94%A7)   | Tools, repair items, materials    |
| ⛽ **Gas Station**     | ![Gas](https://via.placeholder.com/20x20/cc8c52/fff?text=%E2%9B%BD)           | Fuel, snacks, car supplies        |
| 💊 **Pharmacy**       | ![Pharmacy](https://via.placeholder.com/20x20/cc52cc/fff?text=%F0%9F%92%8A)   | Medical supplies, bandages        |
| 🍺 **Liquor Store**   | ![Liquor](https://via.placeholder.com/20x20/8c52cc/fff?text=%F0%9F%8D%BA)     | Alcohol, beverages                |
| 🍔 **Restaurant**     | ![Restaurant](https://via.placeholder.com/20x20/52cc8c/fff?text=%F0%9F%8D%94) | Prepared food, meals              |

#### Map Navigation

1. **Open your map** (M key by default)
2. **Look for shop blips** - colored icons
3. **Set waypoint** to desired shop
4. **Follow GPS** to location

***

### 🛍️ Shopping Process

#### Step 1: Main Shop Interface

<figure><img src="/files/QEQlLT0gMHNmYGFrJ7Pu" alt=""><figcaption></figcaption></figure>

When you open a shop, you'll see the main interface featuring:

**Header Section:**

* **Shop Name & Type** - "Rambo3Dev Test Shop" with shop category
* **Money Display** - Your current cash balance (top right)
* **Shop Icon** - Visual indicator of shop type

**Left Sidebar:**

* **Search Bar** - Find specific items quickly
* **Category Filters** - "All Items", "misc", etc.
* **Store Details** - Shop type and information
* **Your Cart** - Items count and total value
* **Checkout Button** - Proceed to purchase
* **View Cart Button** - Review selected items

**Main Content Area:**

* **Sort Options** - Name, Price (Low-High), Price (High-Low)
* **Item Grid** - Visual display of all available products
* **Item Cards** - Each showing image, name, and price
* **Add Buttons** - Golden "+" buttons to add items

#### Step 2: Item Selection & Details

<figure><img src="/files/J5Tg1jFK1jWvxnH0byBE" alt=""><figcaption></figcaption></figure>

When you click on an item, a detailed dialog opens showing:

**Item Information Panel:**

* **Large Item Image** - Clear visual of the product
* **Item Name** - "Bandage" or product title
* **Detailed Stats:**
  * **Price** - Cost per unit ($10.00)
  * **Category** - Item classification (misc)
  * **Weight** - Item weight (115 kg)
  * **Available** - Stock quantity (50 units)

**Quantity Selection:**

* **Decrease Button** - "-" to reduce quantity
* **Quantity Input** - Current amount selected
* **Increase Button** - "+" to add more
* **Total Price** - Calculated cost for selected quantity

**Action Buttons:**

* **Cancel** - Close dialog without purchasing
* **Add to Cart** - Golden button to confirm selection

#### Step 3: Shopping Cart Management

<figure><img src="/files/andYMg4vLpp1tBBcGKrh" alt=""><figcaption></figcaption></figure>

The shopping cart interface provides:

**Cart Header:**

* **"Shopping Cart" Title** - Clear identification
* **Item List** - All selected products

**Item Management:**

* **Item Cards** - Each showing image, name, and details
* **Price Per Unit** - Individual item cost
* **Quantity Controls** - "-" and "+" buttons for each item
* **Total Per Item** - Calculated cost for quantity
* **Remove Button** - Red trash icon to delete items

**Cart Summary:**

* **Subtotal** - Total before any taxes/fees
* **Final Total** - Complete purchase amount
* **Item Count** - Number of different products

**Navigation Options:**

* **Continue Shopping** - Return to main shop
* **Proceed to Checkout** - Golden button to finalize

#### Step 4: Checkout Process

<figure><img src="/files/IBDcVvLCsX5n37RSHGgO" alt=""><figcaption></figcaption></figure>

The final checkout screen displays:

**Purchase Summary:**

* **Item List** - Final review of all products
* **Individual Prices** - Cost breakdown per item
* **Quantity Confirmation** - Amount of each product

**Payment Breakdown:**

* **Subtotal** - Base cost of all items
* **Tax Information** - Any applicable taxes (0% shown)
* **Final Total** - Complete amount to be charged

**Payment Actions:**

* **Cancel** - Return to cart without purchasing
* **Confirm Purchase** - Golden button to complete transaction

**Transaction Features:**

* **Real-time Calculation** - Instant price updates
* **Clear Pricing** - No hidden fees or charges
* **Secure Processing** - Safe payment handling

***

### 🎨 User Interface Features

#### Modern Shop Design

The shop interface features a sleek, modern design with:

**Visual Elements:**

* **Dark Theme** - Easy on the eyes with professional appearance
* **Golden Accents** - Premium buttons and highlights
* **High-Quality Icons** - Clear item images and interface elements
* **Responsive Layout** - Adapts to different screen sizes

**Navigation Features:**

* **Intuitive Layout** - Logical organization of all elements
* **Clear Typography** - Easy-to-read fonts and text sizes
* **Color Coding** - Green for money, golden for actions
* **Visual Feedback** - Hover effects and button states

#### Interface Navigation Tips

**Efficient Shopping:**

* **Use Search** - Type item names to find products quickly
* **Sort by Price** - Find cheapest or most expensive items
* **Category Filters** - Browse specific item types
* **Cart Preview** - Check your selections before checkout

**Keyboard Shortcuts:**

* **ESC** - Close any dialog or return to previous screen
* **Enter** - Confirm selections in dialogs
* **Tab** - Navigate between interface elements
* **Space** - Alternative to clicking buttons

**Mouse Controls:**

* **Left Click** - Select items and navigate
* **Scroll Wheel** - Browse through item lists
* **Right Click** - Context menus (where available)
* **Hover** - Preview additional information

***

### 💰 Payment & Transactions

#### Payment Methods

The system supports various payment methods:

| Method           | Description                 | Availability         |
| ---------------- | --------------------------- | -------------------- |
| **Cash**         | Physical money in inventory | Always available     |
| **Bank Account** | Digital banking system      | If enabled by server |
| **Credit Card**  | Card-based payments         | Framework dependent  |

#### Transaction Process

1. **Select payment method** from options
2. **Confirm total amount** displayed
3. **Authorize payment** when prompted
4. **Receive confirmation** message
5. **Items added** to inventory automatically

#### Purchase Limits

Some shops may have restrictions:

| Limit Type      | Description                   |
| --------------- | ----------------------------- |
| **Per Item**    | Maximum quantity per purchase |
| **Per Player**  | Daily/weekly purchase limits  |
| **Stock Based** | Limited by shop inventory     |
| **Level Based** | Restricted by player level    |

***

### 📦 Inventory Management

#### Receiving Items

After purchase:

* **Items appear** in your inventory immediately
* **Notification shown** confirming purchase
* **Receipt displayed** with transaction details
* **Inventory space** automatically managed

#### Item Information

Each purchased item includes:

| Detail            | Information           |
| ----------------- | --------------------- |
| **Item Name**     | Product identifier    |
| **Quantity**      | Amount purchased      |
| **Unit Price**    | Cost per item         |
| **Total Cost**    | Final amount paid     |
| **Purchase Time** | Transaction timestamp |
| **Shop Source**   | Where item was bought |

***

### 🎯 Shopping Tips & Best Practices

#### Efficient Shopping Strategies

**Before Shopping:**

* **Check your money** - Verify cash balance before visiting shops
* **Plan your route** - Visit multiple shops in one trip
* **Make a list** - Know what items you need
* **Check inventory space** - Ensure you have room for purchases

**During Shopping:**

* **Use search function** - Find items quickly by typing names
* **Compare prices** - Check different shops for better deals
* **Read item details** - Understand weight and category
* **Check stock levels** - Ensure items are available

**Smart Purchasing:**

* **Buy in bulk** - Purchase multiple items at once
* **Use cart wisely** - Add multiple items before checkout
* **Double-check quantities** - Verify amounts before confirming
* **Review total cost** - Confirm final price before payment

#### Money Management Tips

**Budget Planning:**

* **Track spending** - Monitor your purchases
* **Set limits** - Don't spend all your money at once
* **Save for essentials** - Prioritize important items
* **Compare costs** - Different shops may have different prices

**Cost-Saving Strategies:**

* **Look for deals** - Some shops may offer discounts
* **Buy necessities first** - Focus on essential items
* **Avoid impulse buying** - Think before purchasing
* **Check multiple shops** - Find the best prices

#### Shopping Etiquette & Community

**Respectful Shopping:**

* **Be patient** - Wait for other players to finish
* **Don't block access** - Allow others to reach the shop NPC
* **Share information** - Help other players find good deals
* **Report issues** - Contact admins about problems

**Community Guidelines:**

* **Follow server rules** - Respect shopping regulations
* **Help new players** - Guide newcomers through the process
* **Be courteous** - Maintain friendly interactions
* **Avoid exploitation** - Don't abuse shop systems

***

### 🔍 Shop Features

#### Search & Filter

Many shops offer advanced features:

| Feature                 | Description              |
| ----------------------- | ------------------------ |
| **Search Bar**          | Find items by name       |
| **Category Filter**     | Browse by item type      |
| **Price Sort**          | Order by cost            |
| **Availability Filter** | Show only in-stock items |

#### Item Preview

Before purchasing:

* **View item images** - See what you're buying
* **Read descriptions** - Understand item purpose
* **Check requirements** - Verify you can use the item
* **See stats** - View item properties

***

### 🔍 Advanced Shop Features

#### Smart Shopping Tools

**Search & Filter System:**

* **Real-time Search** - Instant results as you type
* **Category Filtering** - Browse by item type (misc, weapons, etc.)
* **Price Sorting** - Organize by cost (low to high, high to low)
* **Stock Filtering** - Show only available items

**Cart Management:**

* **Persistent Cart** - Items stay selected while browsing
* **Quantity Adjustment** - Change amounts without re-selecting
* **Remove Items** - Easy deletion with trash icon
* **Total Calculation** - Real-time price updates

**Item Information:**

* **Detailed Stats** - Weight, category, availability
* **Visual Preview** - High-quality item images
* **Price Transparency** - Clear cost breakdown
* **Stock Levels** - See how many items are available

#### Shopping Experience Enhancements

**User-Friendly Design:**

* **Responsive Interface** - Works on all screen resolutions
* **Smooth Animations** - Fluid transitions between screens
* **Clear Navigation** - Intuitive button placement
* **Visual Feedback** - Hover effects and confirmations

**Performance Features:**

* **Fast Loading** - Quick interface response
* **Optimized Graphics** - Smooth performance
* **Memory Efficient** - Minimal resource usage
* **Stable Operation** - Reliable functionality

***

### 🚨 Troubleshooting Customer Issues

#### Common Interface Problems

| Issue                     | Possible Cause       | Solution                                  |
| ------------------------- | -------------------- | ----------------------------------------- |
| **Shop won't open**       | Too far from ped     | Move closer to shop NPC (within 3 meters) |
| **Interface not loading** | UI resource issue    | Restart FiveM or reconnect to server      |
| **Items not showing**     | Network lag          | Wait a moment or close/reopen shop        |
| **Can't click buttons**   | Cursor mode issue    | Press ESC and try again                   |
| **Search not working**    | Text input focus     | Click in search box first                 |
| **Cart not updating**     | Interface sync issue | Refresh by closing and reopening          |

#### Purchase & Payment Issues

| Issue                  | Possible Cause     | Solution                                |
| ---------------------- | ------------------ | --------------------------------------- |
| **Purchase failed**    | Insufficient funds | Check your cash balance (top right)     |
| **Items not received** | Inventory full     | Make space in your inventory            |
| **Payment declined**   | Server lag         | Wait and try again                      |
| **Wrong quantity**     | Input error        | Double-check quantity before confirming |
| **Price mismatch**     | Display lag        | Refresh interface and verify prices     |

#### Error Messages Explained

| Message                  | Meaning                  | Action Required                      |
| ------------------------ | ------------------------ | ------------------------------------ |
| "Insufficient funds"     | Not enough money         | Earn more money or buy fewer items   |
| "Inventory full"         | No inventory space       | Drop or store some items             |
| "Item out of stock"      | Shop inventory empty     | Try another shop or wait for restock |
| "Purchase limit reached" | Hit buying restrictions  | Wait for limit reset period          |
| "Transaction failed"     | Payment processing error | Try again or contact admin           |
| "Shop unavailable"       | Shop temporarily closed  | Check back later                     |

#### Getting Help & Support

**Immediate Solutions:**

1. **Try basic fixes** - Close/reopen shop, move closer to NPC
2. **Check your status** - Verify money, inventory space, connection
3. **Ask other players** - See if it's a server-wide issue
4. **Wait briefly** - Some issues resolve with time

**For Persistent Problems:**

1. **Contact server admins** - Report bugs with details
2. **Join Discord community** - Get help from other players
3. **Check server announcements** - Look for known issues
4. **Provide details** - Include error messages and steps taken

***

### 📱 Interface Compatibility & Accessibility

#### Screen & Resolution Support

The shop interface is designed for universal compatibility:

**Resolution Support:**

* **1920x1080** - Full HD (recommended)
* **1366x768** - Standard laptop resolution
* **2560x1440** - 2K displays
* **3840x2160** - 4K displays
* **Ultrawide** - 21:9 aspect ratio support

**Scaling Features:**

* **Auto-scaling** - Interface adapts to screen size
* **UI Scale Respect** - Follows FiveM UI scaling settings
* **Text Readability** - Clear fonts at all sizes
* **Button Sizing** - Appropriate touch targets

#### Accessibility Features

**Visual Accessibility:**

* **High Contrast** - Clear distinction between elements
* **Color Coding** - Meaningful use of colors (green for money, gold for actions)
* **Large Text** - Readable font sizes
* **Clear Icons** - Recognizable interface symbols

**Navigation Accessibility:**

* **Keyboard Support** - Full keyboard navigation
* **Mouse Alternative** - Tab navigation available
* **Clear Focus** - Visible selection indicators
* **Logical Flow** - Intuitive interface progression

#### Control Options

| Input Method | Supported Actions                           |
| ------------ | ------------------------------------------- |
| **Mouse**    | Full interface control, clicking, scrolling |
| **Keyboard** | Navigation, shortcuts, text input           |
| **Gamepad**  | Basic navigation (server dependent)         |
| **Touch**    | Limited support on compatible devices       |

**Keyboard Shortcuts Reference:**

| Key            | Function                       | Context              |
| -------------- | ------------------------------ | -------------------- |
| **E**          | Open shop interface            | Near shop NPC        |
| **ESC**        | Close current dialog/interface | Any shop screen      |
| **Enter**      | Confirm action/purchase        | Dialog boxes         |
| **Tab**        | Navigate between elements      | Interface navigation |
| **Backspace**  | Clear search field             | Search box active    |
| **Arrow Keys** | Navigate item grid             | Item selection       |
| **Space**      | Alternative to clicking        | Button activation    |

***

### 🌟 Advanced Shopping Features & Tips

#### Smart Shopping Tools

**Search Optimization:**

* **Partial Matching** - Type part of item name for results
* **Case Insensitive** - Search works regardless of capitalization
* **Real-time Results** - Instant filtering as you type
* **Clear Function** - Easy search reset

**Category Management:**

* **Quick Filters** - One-click category selection
* **Mixed Categories** - Items can appear in multiple categories
* **Custom Categories** - Server-specific item groupings
* **Visual Indicators** - Clear category identification

**Price Comparison:**

* **Sort Functions** - Organize by price (low to high, high to low)
* **Value Assessment** - Compare price per unit
* **Stock Awareness** - Consider availability in decisions
* **Budget Planning** - Track spending against available funds

#### Shopping Efficiency Features

**Cart Management:**

* **Persistent Storage** - Cart contents saved while browsing
* **Bulk Operations** - Add multiple items quickly
* **Quantity Adjustment** - Modify amounts without re-selection
* **Quick Removal** - One-click item deletion

**Purchase Optimization:**

* **Batch Processing** - Buy multiple items in one transaction
* **Stock Verification** - Real-time availability checking
* **Price Calculation** - Instant total updates
* **Payment Confirmation** - Clear transaction summary

#### Quality of Life Improvements

**User Experience:**

* **Smooth Animations** - Fluid interface transitions
* **Loading Indicators** - Clear feedback during operations
* **Error Prevention** - Validation before actions
* **Success Confirmation** - Clear purchase completion

**Performance Features:**

* **Fast Response** - Quick interface reactions
* **Memory Efficient** - Minimal resource usage
* **Network Optimized** - Reduced server communication
* **Stable Operation** - Reliable functionality

***

### 🎓 Customer Success Guide

#### First-Time Shopping Checklist

**Before Your First Purchase:**

1. ✅ **Verify your money** - Check cash balance
2. ✅ **Find a shop** - Locate shop blips on map
3. ✅ **Approach NPC** - Get within interaction range
4. ✅ **Test interface** - Open and explore shop UI
5. ✅ **Practice navigation** - Try search and categories
6. ✅ **Make small purchase** - Start with inexpensive items

**Shopping Best Practices:**

* **Start small** - Begin with basic items
* **Learn the interface** - Explore all features
* **Check prices** - Compare costs between shops
* **Manage inventory** - Keep space for purchases
* **Ask for help** - Other players can provide guidance

#### Becoming a Smart Shopper

**Advanced Techniques:**

* **Route Planning** - Optimize travel between shops
* **Bulk Buying** - Purchase multiple items efficiently
* **Price Tracking** - Remember good deals for future reference
* **Inventory Management** - Balance purchases with storage
* **Community Engagement** - Share tips with other players

**Long-term Success:**

* **Budget Management** - Track spending patterns
* **Shop Familiarity** - Learn which shops have what items
* **Relationship Building** - Connect with other shoppers
* **Server Knowledge** - Understand server-specific features

***

### 🎉 Ready to Start Shopping?

![Shopping Success](https://via.placeholder.com/600x200/1a1a1a/ffcc00?text=Happy+Shopping+with+Rambo3Dev+Shops!)

**You're now equipped with everything you need to become a master shopper!**

#### 🔗 Quick Navigation

| Section           | Description                  |
| ----------------- | ---------------------------- |
| 🏠 Home           | Return to main documentation |
| 📖 Overview       | System overview and features |
| ⚙️ Installation   | Setup and configuration      |
| 👨‍💼 Admin Guide | Shop management and creation |

#### 🆘 Need Help?

**Support Resources:**

[![Discord](https://img.shields.io/badge/DISCORD-JOIN%20COMMUNITY-5865F2?style=for-the-badge\&logo=discord\&logoColor=white)](https://discord.gg/tajGY2tSN7) [![GitBook](https://img.shields.io/badge/GITBOOK-READ%20DOCS-4A90E2?style=for-the-badge\&logo=gitbook\&logoColor=white)](https://rambo3dev.gitbook.io/rambo3dev)

***

**Happy Shopping!** 🛒✨ **Enjoy your premium shopping experience!**

*Created with ❤️ by Rambo3Dev - Your trusted FiveM scripting partner*
