Installation

Installation Guide – v42-Pawnshop

Step 1: Ensure All Dependencies Are Installed

Before proceeding, confirm that all required dependencies for your framework (QBCore or ESX) are:

• Installed

• Running properly

• Using the latest stable versions

Required Systems:

• Framework: QBCore or ESX

• Inventory: qb-inventory or ox_inventory

• Targeting: qb-target or ox_target

---

Step 2: Install the Resource

1. Drag and drop the v42-pawnshop folder into your server’s resources directory.

2. Add the following line to your server.cfg after all dependencies:

ensure v42-pawnshop

---

Step 3: Add Items & Images

Ensure any tradeable items used in the pawnshop (like phone, laptop, rolex, etc.) exist in your shared items file or database.

🔧 If your inventory supports images, add corresponding icons to your inventory UI (e.g., html/images/ or ox_inventory/web/images/).

---

Step 4: Import SQL Files

This script does not require SQL installation by default. However, ensure that all referenced item names exist in your items table or inventory system.

---

Step 5: Configure the Script

Open config.lua and set up the global settings:

• Config.Framework – Set to 'qb' or 'esx'

• Config.CoreName – Use your framework’s folder name (e.g., 'qb-core')

• Config.Inventory – Choose 'qb-inventory' or 'ox_inventory'

• Config.Target – Choose 'qb-target' or 'ox_target'

• Config.Debug – Set to true during setup/testing

---

Step 6: Configure Pawnshops and Items

In config.lua, customize:

💬 Add/Modify Pawnshop Locations

Edit or add to the Config.ShopPed table. Example:

Config.ShopPed["Downtown Pawnshop"] = {
  pos = vector4(250.45, -1045.67, 29.32, 90.0),
  model = 'mp_m_shopkeep_01',
  blip = {
    sprite = 52,
    color = 5,
    scale = 0.8,
    name = "Downtown Pawnshop"
  }
}

📦 Add Tradeable Items

Define tradeable items in Config.PawnShops. Example:

['phone'] = {                                                       -- item name / image name (must match inventory)
    ['label'] = 'Phone',                                            -- Display name in the UI
    ['required'] = {                                                -- Required items for the trade
        phone = { amount = 1, label = 'Phone' },                    -- Item name and label (what the player gives)
    },
    ['rewards'] = {                                                 -- What the player receives
        cash = { amount = 1500, minAmount = 1200, label = 'Cash' }, -- Currency/item reward (use "cash" for money)
    }
},

You can define multiple shops, categories, and reward combinations per shop.

---

Step 7: Start or Restart the Server

To apply all changes:

• Run the following in your server console or F8:

  refresh
  ensure v42-pawnshop

• Or restart your server

---

Notes

• Supports multiple pawnshops with separate inventories

• Compatible with both qb-target and ox_target

• You can restrict shop access to specific jobs using jobName per shop

• Always test item trades and rewards in a local or test environment before going live