Configuration

Main configuration file: shared/config.lua.

Core settings

Config.Locale = 'en'
Config.Notify = 'okok'
Config.Debug = false
Config.WebhookShopPurchase = ''
Config.WebhookItemPurchase = ''

• Config.Locale: active language (en or hr, based on existing locale files).

• Config.Notify: notification provider (okok, ox, qb, esx, or auto).

• Config.Debug: enables server/client debug logs.

• Webhook*: currently defined in config, but not actively used in server logic.

Vehicle keys

Config.VehicleKeySystem = 'auto'

Possible values:

• auto (autodetect)

• qb-vehiclekeys

• wasabi_carlock

Economy and pricing

Config.PercentageToShop = 50
Config.PriceChangeLimit = 35

• PercentageToShop: percentage of each sale that goes to shop company balance.

• PriceChangeLimit: how much the owner can move price from item buyPrice.

Limit formula:

• min = buyPrice * (1 - limit/100)

• max = buyPrice * (1 + limit/100)

NPC and shop types

Config.NPCModel = 'mp_m_shopkeep_01'
Config.ShopTypes = { ... }

Each type in Config.ShopTypes contains:

• blip: sprite, color, scale, label

• items: list of items

Item format:

{ name = 'item_name', label = 'Item Label', price = 100, buyPrice = 70 }

• price: default sale price to customers

• buyPrice: supplier purchase price and base for owner price limits

Supplier and delivery

Config.Suppliers = {
  regular = vec4(...),
  gun = vec4(...),
  it = vec4(...)
}

Config.DeliveryVehicleModel = 'speedo'
Config.DeliveryVehiclePlate = '3MSUP'

• Config.Suppliers: pickup locations per shop type.

• DeliveryVehicleModel: delivery vehicle model.

• DeliveryVehiclePlate: delivery vehicle plate.

Admin permissions

Config.AdminAce = 'command'

Recommendation:

• use a custom ACE (for example playerShops.admin) instead of generic command

• configure ACE permissions in server.cfg

Framework / inventory / target bridge

The script auto-detects:

• framework: es_extended, qbx_core, qb-core

• inventory: ox_inventory, qb-inventory (framework fallback)

• target: ox_target, qb-target

• notification provider: based on Config.Notify and running resources

If you use a custom stack, adjust:

• bridge/framework.lua

• bridge/inventory.lua

• client/cl_target.lua

• shared/notify.lua

Localization

Files:

• Locales/en.lua

• Locales/hr.lua

Enable language:

Config.Locale = 'hr'

To add a new language:

1. duplicate one locale file

2. translate strings

3. add it in fxmanifest.lua under shared_scripts

4. set Config.Locale