# 1017-DEV-PAWNS

<figure><img src="https://598044428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2YEySnTvDJiwfeFb4sI3%2Fuploads%2FUlW8dmbecOK3T4kzUXEE%2FQB%20Clothing%20Item%20(2).png?alt=media&#x26;token=341ef783-80fb-4480-9a6d-2c4ada960b9d" alt=""><figcaption></figcaption></figure>

***

## 🏪 1017-DEV PAWNSHOP v1.2.4

**A FiveM pawnshop system for QBCore & Qbox featuring a modern tablet UI, melting system, missions, and a fully player-driven marketplace.**

🔗 **Discord:** <https://discord.gg/YwhcX3td96>

***

### 📋 Table of Contents

* ✨ Features
* 🔧 How It Works
* 🚀 Installation
* ⚙️ Configuration
* 📦 Dependencies
* 💬 Support
* 📜 License

***

### ✨ Features

#### 💰 Item Selling System

* Sell **items**&#x20;
* Dynamic pricing with random value ranges
* Instant payout (cash or bank configurable)

***

#### 🔥 Jewelry Melting System

* Melt valuable jewelry into raw materials
* Custom melt times per item
* Progress tracking inside tablet UI
* Optional email notification on completion

***

#### 📦 Mission System (3 Tier Rewards)

Players complete delivery-style missions with **random reward tiers**:

* 🟢 **Standard (50%)**
  * Basic items (coffee, lockpicks, metalscrap)
* 🟡 **Valuable (30%)**
  * Gold bars, rolex, diamond rings
* 🔴 **Premium (20%)**
  * Rare gems, antique coins, multiple diamonds

**Features:**

* GPS route system
* Speedo van spawn system
* 5 pickup locations
* Mission completion rewards

***

#### 🏪 Stock Marketplace (Player Economy)

A full **player-to-player trading system**:

* List items for sale
* Browse player listings
* Buy items from other players
* Offline payment storage system
* Collect earnings via pawnshop NPC

***

#### 📱 Advanced Tablet UI

* Modern design
* Smooth animations
* 4 integrated apps:
  * Sell
  * Melt
  * Missions
  * Stock Market
* Inventory integration
* Real time updates

***

#### 🛡️ Security & Anti-Exploit

* Server-side validation for all actions
* Distance verification checks
* Inventory ownership validation
* Secure transaction handling

***

### 🔧 How It Works

#### 🧭 Basic Workflow

1. Go to pawnshop location
2. Interact with NPC target eye
3. Open tablet interface
4. Choose system:
   * Sell Items
   * Melt Items
   * Start Missions
   * Use Stock Market

***

#### 📦 Mission Flow

1. Start mission from tablet
2. GPS route is created
3. Go to pickup locations
4. Load items into Speedo van
5. Return vehicle to pawnshop
6. Receive reward based on tier

***

#### 🏪 Marketplace Flow

**Selling Items:**

1. Open Stock App
2. Select item from inventory
3. Set price
4. Item is listed for other players

**Buying Items:**

1. Browse listings
2. Purchase item
3. Seller receives money (online or stored if offline)

**Collect Earnings:**

* Interact with pawnshop NPC
* Claim all pending payments

***

### 🚀 Installation

#### 1. Dependencies

Make sure these are installed:

* ox\_lib
* oxmysql
* ox\_inventory **or** codem-inventory
* ox\_target **or** qb-target

***

#### 2. Install Script

1. Place folder:

```
resources/[1017]/1017-dev-pawnshop
```

2. Import SQL:

```
pawnshop_stock.sql
```

3. Add to server.cfg:

```bash
ensure 1017-dev-pawnshop
```

***

#### 3. Configuration

Edit:

```
shared/config.lua
```

Adjust:

* Locations
* Prices
* Missions
* Melt system
* Payment type

***

#### 4. Restart Server

```bash
restart 1017-dev-pawnshop
```

***

### ⚙️ Configuration Examples

#### 💰 Pawnshop Settings

```lua
Config.BankMoney = false -- false = cash, true = bank
```

***

#### 📦 Mission Rewards Chances

```lua
Config.MissionRewardChances = {
    random = 50,
    valuable = 30,
    premium = 20
}
```

***

#### 🔥 Custom Items

```lua
Config.PawnItems = {
    {
        item = "phone",
        price = math.random(100, 200),
        category = "electronics"
    }
}
```

***

#### 🔥 Melting System

```lua
Config.MeltingItems = {
    {
        item = "diamond_ring",
        meltTime = 0.15,
        rewards = {
            { item = "diamond", amount = 1 }
        }
    }
}
```

***

### 💬 Support

Need help?

🎮 Discord: <https://discord.gg/YwhcX3td96>

We provide:

* Installation support
* Bug fixes
* Feature requests
* Community help

***

**Version:** 1.2.4\
**Framework:** QB-Core / Qbox\
**Type:** Premium Economy Script

***

{% hint style="info" %}
Need more help ? Join our discord : [1017 Development Discord](https://discord.gg/YwhcX3td96)
{% endhint %}