Installation

Dependencies

QBCore

QBCore Framework

ESX

ESX Framework

---

How to install

Drag the script in your folder, ensure & choose your Framework.

Config.Framework = "ESX"                        -- "ESX" or "QBCore"
Config.CorePrefix = "es_extended"               -- "qb-core" - "es_extended" or custom export

You can use your own custom export to draw a text as interaction.

Config.ShowInteractText = true                  -- If false you can use your own Config.ShowText function with your own export etc.

Config.ShowText = function()
    --exports['qb-core']:DrawText('message','position')
end

---

The products available in the stores are not automatically included in your inventory. They are custom items, which you can choose to add or remove from your collection as you see fit. Therefore, don't be surprised if the items aren't immediately available in your inventory after purchase.

Create custom shops

By following this guide you can create your custom shop. Every type of shops are createable!

-- Store example
    -- {
    --     name = '24/7', -- Required and needs to be unique from the other stores
    --     title = '24/7 Supermarket', -- Required, is shown in the header and the blip
    --     logo = 'https://i.imgur.com/pXRRvoB.png', -- Optional.
    --     colors = { -- All of these inside colors are required
    --         bg = 'rgba(100, 100, 100, .3)', -- Background color for the boxes and containers
    --         bgGradient = 'rgba(4, 180, 71, 0.2)', -- Background gradient color
    --         primary = 'rgb(4, 180, 7)', -- Color for highlighted items and buttons
    --         text = '#fff' -- Make sure it has high contrast with the background color
    --         colorCode = '~g~' -- Optional. The color for the interaction text. Default is ~g~
    --     },
    --     categories = {
    --         {
    --             title = 'Test category',
    --             products = {
    --                 { 
    --                     label = 'Test product', 
    --                     name = 'test_product', 
    --                     price = 20,
    --                     image = '' 
    --                 }
    --             }
    --         }
    --     },
    --     blip = { -- Optional. If removed, the store will not show a blip on the map.
    --         sprite = 59, -- Required. The sprite of the blip.
    --         scale = 0.8, -- Optional. The scale of the blip. Default is 0.8.
    --         color = 3 -- Optional. The color of the blip. Default is 4.
    --     },
    --     ped = { -- Here you can define the ped that will be spawned when the store is opened.
    --         model = "mp_m_shopkeep_01", -- Required. Ped list: https://docs.fivem.net/docs/game-references/ped-models
    --         scenario = '', -- Optional, you can add a scenario. Scenario list: https://pastebin.com/6mrYTdQv
    --         animation = { -- Optional, you can add an animation. 
    --             dict = '',
    --             anim = ''
    --         }
    --     },
    --     locations = { -- Required. The list of locations where the store will be available. If you have peds and you want a specific heading for each one, you have to define the locations as vector4s.
    --         vector3(0, 0, 0)
    --     }
    -- },