Lyra Shops · Start here

Configuration

The main options in shared/config.lua and the admin panel config.

Most settings are in LyraShops/shared/config.lua. The admin panel has its own small LyraAdminShops/config.lua.

Main options

Option	What it does
`Config.Framework`	`'qbox'`, `'qbcore'` or `'esx'`
`Config.Interaction`	`'ox_target'`, `'qb-target'` or `'key'` (press E near the shopkeeper)
`Config.Inventory`	`'ox_inventory'` or `'qb-inventory'` (`'qb-inventory-old'` for pre-2024 qb-inventory)
`Config.Notify`	`'ox_lib'`, `'qbcore'`, `'qbox'` or `'esx'`
`Config.Locale`	`'en'` or `'ar'` (the UI switches to right-to-left for Arabic)
`Config.Money`	Account used for store prices, rent and upgrades: `'cash'` or `'bank'`
`Config.StorePedModel`	Shopkeeper model
`Config.InteractDistance`	How close players must be to interact
`Config.MaxEmployees`	Employees per store (the owner is not counted)
`Config.ImagesDirectory`	Where item images are loaded from, per inventory

Ranks & permissions

Every action has its own list of allowed ranks. The owner can always do everything.

lua

Config.Permissions = {
    RemoveCategory = { "manager" },
    AddCategory = { "manager", "assistant" },
    WithdrawMoney = { "manager", "assistant" },
    DepositMoney = { "manager", "assistant", "worker" },
    ManageEmployees = { "manager" },
    ChangeStoreName = { "manager" },
    WholesaleAccess = { "manager", "assistant", "worker" },
    UpgradeLevel = { "manager" }
}

Config.Ranks sets the rank names shown in the UI.

Products

Config.DefaultProducts: what a store sells before anyone owns it. Every unowned store uses this list, and its stock never runs out.
Config.BlacklistedItems: items players can never put up for sale.

Other config files

File	Contents
`shared/ConfigStore.lua`	Stores created automatically on start
`shared/level_config.lua`	The level system
`shared/wholesale_config.lua`	Wholesale products, suppliers and crates
`shared/config_weapon.lua`	Weapon stores
`server/config_webhooks.lua`	Discord webhooks

Admin panel config

lua

Config.Framework = 'qbcore'      -- 'qbcore', 'qbox' or 'esx' (same as LyraShops)
Config.Command = 'adminshops'
Config.AdminPermission = 'admin' -- QB permission or ESX group
Config.Notify = 'qbcore'

Players with the ACE permission command can also open the panel.

← Previous

Getting started

Frameworks & inventories

Last updated 28 Oct 2026 by Lyra