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

  • 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

Each type in Config.ShopTypes contains:

  • blip: sprite, color, scale, label

  • items: list of items

Item format:

  • price: default sale price to customers

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

Supplier and delivery

  • Config.Suppliers: pickup locations per shop type.

  • DeliveryVehicleModel: delivery vehicle model.

  • DeliveryVehiclePlate: delivery vehicle plate.

Admin permissions

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:

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

Last updated