All server-wide settings live in cfg.lua. It is the only file most servers will touch.
Restart the resource after editing cfg.lua for changes to take effect.
Editable files
The resource is protected via the Cfx escrow system. Two paths are left open via escrow_ignore so you can tailor them to your server:
| File | Purpose |
|---|
cfg.lua | Main config — society banking, UI colors, keybinds, and the dispatch widget. |
locales/* | Translation strings (JSON — edit freely). |
Everything else is escrowed. If you need a config option exposed that isn’t currently in cfg.lua, open a support ticket.
Society banking
Config.Society selects which banking backend receives sales deposits. Pick the one that matches your framework.
| Value | Backend |
|---|
'esx' | ESX’s built-in society / addon_account_data. (Default.) |
'qb' | QBCore — uses qb-banking if started, otherwise qb-management. |
'qbox' | QBox — uses qbx_management (or qb-banking if you run that). |
'external' | An arbitrary banking resource named in Config.BankingExport. |
Config.BankingExport is only consulted when Config.Society = 'external'. Set it to the resource name whose :handleTransaction / :addAccountMoney exports should receive society deposits.
-- Only used when Config.Society = 'external'.
Config.BankingExport = ''
The external resource must provide :handleTransaction and :addAccountMoney exports with the signature this script expects. If society deposits aren’t landing, the backend is the first thing to check.
UI theme
Config.UI.colors is the server-wide default palette pushed to the UI at boot. Every value is a CSS color string (hex / rgb / hsl). Players can still override these locally from the UI Preferences panel (F7); their choices are saved client-side in localStorage.
Config.UI = {
font = 'Inter',
colors = {
primary = '#a855f7', -- main accent (buttons, glow, highlights)
primaryHover = '#c084fc', -- accent on hover / focus
accent = '#7c3aed', -- secondary accent (gradients, borders)
bg = '#0a0612', -- darkest backdrop behind panels
surface = '#170d24', -- panel surface
surfaceAlt = '#1f1330', -- elevated rows (hover, selected)
border = '#3b1f6b', -- panel border / divider
text = '#f3e8ff', -- primary text
textMuted = '#a78bfa', -- secondary / description text
success = '#22c55e',
warning = '#f59e0b',
danger = '#ef4444',
},
}
Change a color and the whole UI re-skins on the next resource restart.
Keybinds
Config.UI.settingsKey sets the default key for opening the UI Preferences panel.
Config.UI.settingsKey = 'F7'
Config.UI.dispatch.* controls the order tickets widget — its keybinds, behaviour, and width.
Config.UI.dispatch = {
enabled = true,
toggleKey = 'U', -- toggle the panel visible/hidden
altToggleKey = 'I', -- second toggle key (mirrors toggleKey)
prevKey = 'LEFT', -- cycle to previous order
nextKey = 'RIGHT', -- cycle to next order
autoShowOnNewOrder = true, -- auto-show on a new order, even if hidden
width = 340, -- panel width in px
}
| Key | Default | What |
|---|
settingsKey | F7 | Opens the UI Preferences panel. |
dispatch.toggleKey | U | Toggles the order tickets widget. |
dispatch.altToggleKey | I | Second toggle key — mirrors toggleKey. |
dispatch.prevKey | LEFT | Previous order ticket. |
dispatch.nextKey | RIGHT | Next order ticket. |
These are the defaults registered through FiveM’s keymap. Each player can rebind them under Settings → Key Bindings → FiveM → nex_businesses, so a player who already uses U or I for something else can change them without editing config.
Set Config.UI.dispatch.enabled = false to disable the widget entirely. Set autoShowOnNewOrder = false to require employees to press the toggle manually instead of having the panel pop up on each new order.
Offline shops
Config.DisableOfflineShops is a server-wide kill switch for the offline shopkeeper ped system.
Config.DisableOfflineShops = false -- set true to disable offline shops
When true, no offline shop peds spawn anywhere on the server, regardless of what bosses have placed. See Management for how the offline shop is stocked.
Other options
A few additional toggles are available in cfg.lua:
| Key | Default | What |
|---|
Config.useChairs | true | Enables the built-in chair system. |
Config.chairsTextUi | false | If false, uses the ox_lib radial menu for chairs instead of textUI. |
Config.DisabledRegisters | false | Set true to disable the register system. |
Config.StationIndicators | true | Floating markers above stations, drawn only to on-duty employees inside the zone. |
Config.DisabledIngredientShop | false | Set true to disable the ingredient shop system. |
Config.debugConfig | false | Logs whether a business is not set up correctly. |