Configuration

UI Theme

Config.UiTheme = 'blackandwhite'

Changes the appearance of the user interface.

Available Themes

Example:

Config.UiTheme = 'yellow'

Custom Theme Presets

Config.CustomThemePresets = {}

Create your own custom UI theme or override an existing one.

Example:

Config.CustomThemePresets = {
    custom = {
        primary = '#00BFFF',
        primaryRgb = '0, 191, 255'
    }
}

Config.UiTheme = 'custom'

Properties

Default Ped Model

Config.DefaultPedModel = 'a_m_m_bevhills_02'

Default NPC model used if a shop does not specify its own pedModel.

Example:

Config.DefaultPedModel = 'a_m_y_business_01'

Shops

All shops are defined inside:

Config.Shops = {}

You can create as many shops as you like by adding new entries.

Example:

Config.Shops = {
    [1] = {},
    [2] = {},
    [3] = {}
}

Shop Name

name = 'Bean Machine'

The display name of the shop.

Example:

name = '24/7 Supermarket'

Ped Model

pedModel = 'a_f_y_hipster_02'

NPC model used for this shop.

If omitted, the script will use Config.DefaultPedModel.

Example:

pedModel = 'mp_m_shopkeep_01'

Ped Coordinates

PedCoords = vec4(x, y, z, heading)

Location where the shop NPC will spawn.

Example:

PedCoords = vec4(119.93, -1041.76, 29.34, 72.99)

Format

vec4(X, Y, Z, Heading)

Blip

blip = true

Enable or disable the map blip.

Blip Sprite

blipSprite = 536

The icon displayed on the GTA V map.

Use any valid GTA V Blip Sprite ID.

Blip Color

blipColor = 1

Sets the color of the map blip.

Use any valid GTA V Blip Color ID.

Blip Scale

blipScale = 0.8

Controls the size of the map blip.

Example values:

0.5
0.8
1.0
1.2

Job

job = 'police'

Defines which job owns this shop.

Only employees of this job can manage the business.

Example:

job = 'mechanic'

job = 'ambulance'

job = 'burgershot'

Management Grade

minManageGrade = 2

Minimum job grade required to access the management panel.

Example:

minManageGrade = 3

Only employees with grade 3 or higher can manage the shop.

Withdrawal Grade

minManageWithdrawalGrade = 4

Minimum job grade required to withdraw money from the business account.

Example:

minManageWithdrawalGrade = 5

Management Location

manageshop = vec4(x, y, z, heading)

Location where employees can access the management menu.

Example:

manageshop = vec4(112.40, -1044.50, 29.32, 71.98)

Prevent Job Purchases

preventJobBuy = false

Prevent employees from purchasing items from their own business.

Blacklisted Items

BlacklistedItems = {
    'money'
}

Items that can never be stocked or sold by this shop.

These items remain blocked even when AllowItems = 'all'.

Example:

BlacklistedItems = {
    'money',
    'weapon_pistol',
    'bank_card'
}

Maximum Purchases Per Player

MaxPurchasePerson = 200

Maximum quantity a single player can purchase from this shop.

Example:

MaxPurchasePerson = 50

Discord Webhook

discordWebhook = {
    enabled = false,
    webhookUrl = '',
    color = 3066993,
}

Logs shop activity to Discord.

Enable Logging

enabled = true

Enables Discord webhook logging.

Webhook URL

webhookUrl = ''

Paste your Discord webhook URL.

Example:

webhookUrl = 'https://discord.com/api/webhooks/...'

Embed Color

color = 3066993

Color used for Discord embeds.

Use any decimal embed color.

Allowed Items

Determines which items this shop is allowed to stock and sell.

Allow All Items

AllowItems = 'all'

Allows every inventory item except those listed in BlacklistedItems.

Allow Specific Items Only

AllowItems = {
    'water',
    'bread',
    'coffee',
    'burger'
}

Only the listed items can be stocked and sold.

Creating Multiple Shops

Simply duplicate an existing shop configuration.

Example:

Config.Shops = {

    [1] = {
        name = '24/7 Supermarket',
        ...
    },

    [2] = {
        name = 'Bean Machine',
        ...
    },

    [3] = {
        name = 'Burger Shot',
        ...
    }

}

Each shop can have its own:

• Shop Name
• NPC Model
• NPC Location
• Management Location
• Job Owner
• Employee Permissions
• Allowed Items
• Blacklisted Items
• Purchase Limit
• Blip Settings
• Discord Webhook

There is no limit to the number of shops you can create.