Skip to content

Latest commit

 

History

History
103 lines (86 loc) · 4.09 KB

qb-shops.md

File metadata and controls

103 lines (86 loc) · 4.09 KB
description
Ya'll got doritos?

🏪 qb-shops

Introduction

  • Works in conjunction with qb-inventory.md to let players buy items
  • Includes delivery system for players to earn money while refilling stock of shop

Creating a Shop

{% hint style="warning" %} Options highlighted in yellow are optional! {% endhint %}

Defining Products

You can define a table of items inside a unique product list with multiple options available. The index of our table of items will be our unique product list name that we can use later so make sure to keep them different! Let's go over what needs to be included in our product list

  • product list: string
  • name: string
  • amount: number
  • info: table
  • requiredJob: table | string
  • requiredGang: table | string
  • requiredGrade: number
  • requiredLicense: table | string

Example:

['normal'] = {
    { name = 'sandwich',      price = 2,   amount = 50, },
    { name = 'water_bottle',  price = 2,   amount = 50, info = { quality = 100 } },
    { name = 'kurkakola',     price = 2,   amount = 50, requiredJob = 'police' },
    { name = 'twerks_candy',  price = 2,   amount = 50, requiredGang = 'ballas' },
    { name = 'kurkakola',     price = 2,   amount = 50, requiredJob = { 'police', 'ambulance' } },
    { name = 'twerks_candy',  price = 2,   amount = 50, requiredGang = { 'ballas', 'lostmc' } },
    { name = 'snikkel_candy', price = 2,   amount = 50, requiredGrade = 3 },
    { name = 'sandwich',      price = 2,   amount = 50, requiredLicense = 'weapon' },
    { name = 'sandwich',      price = 2,   amount = 50, requiredLicense = { 'weapon', 'driver' } },
},

{% hint style="warning" %} When using a table for requirements, they are EITHER/OR and not both. So if we add police and ambulance as requirements, you will not need both jobs, only one of them! {% endhint %}

Defining Locations

You can define a list of shops which are indexed by a unique identifier. These identifier's must be different because it allows for the restocking of the shop if it's set to true.

  • label: string
  • products: table
  • coords: vector
  • delivery: vector
  • ped: string
  • scenario: string
  • radius: float
  • targetIcon: string
  • targetLabel: string
  • showblip: boolean
  • blipsprite: number
  • blipscale: float
  • blipcolor: number
  • radius: float
  • useStock: boolean
  • requiredJob: string | table
  • requiredGang: string | table
  • requiredItem: string | table

Example:

['247supermarket'] = {
    ['label'] = '24/7 Supermarket',
    ['products'] = Config.Products['normal'],
    ['coords'] = vector4(24.47, -1346.62, 29.5, 271.66),
    ['delivery'] = vector4(26.45, -1315.51, 29.62, 0.07),
    ['ped'] = 'mp_m_shopkeep_01',
    ['scenario'] = 'WORLD_HUMAN_STAND_MOBILE',
    ['targetIcon'] = 'fas fa-shopping-basket',
    ['targetLabel'] = 'Open Shop',
    ['showblip'] = true,
    ['blipsprite'] = 52,
    ['blipscale'] = 0.6,
    ['blipcolor'] = 0,
    ['radius'] = 1.5,
    ['useStock'] = true,
    ['requiredJob'] = 'police', -- string
    ['requiredJob'] = { ['mechanic'] = 4 }, -- table
    ['requiredGang'] = 'ballas', -- string
    ['requiredGang'] = { ['ballas'] = 4 }, -- table
    ['requiredItem'] = 'lockpick', -- string
    ['requiredItem'] = { 'lockpick', 'sandwich' } -- table
},

{% hint style="danger" %} When setting requiredJob, requiredGang or requiredItem do not use both string and table methods, only choose one! {% endhint %}