Most problems come down to a missing dependency, a wrong version, or a start-order mistake. Work through the checks below before opening a ticket.
Red errors in the console
Red errors on boot almost always mean a missing dependency or a wrong version.
- Confirm every resource in the requirements table is installed and meets its minimum version:
oxmysql 2.4.0, ox_lib 3.2.1, ox_inventory 2.30.7, ox_target (latest), plus one framework (es_extended 1.10+, qb-core, or qbx_core).
- Read the error text — it usually names the resource or export that’s missing.
The resource won’t start or events don’t fire
The folder must be named exactly nex_businesses. The script registers its events and exports under this name, and renaming the folder breaks them.
Dependency start order
nex_businesses must start after its dependencies. In server.cfg, start your framework first, then the dependencies, then the script:
ensure es_extended # (or qb-core / qbx_core)
ensure oxmysql
ensure ox_lib
ensure ox_inventory
ensure ox_target
ensure nex_businesses
nex_businesses is started before any of these, you’ll see errors about missing exports.
/createbusiness says the job doesn’t exist
/createbusiness only links a pre-existing framework job to the new business. Create the job in your framework’s job manager first, then run the command again.
A boss can’t open setup or management
/setupbusiness and /managebusiness are gated by job and manager grade, not by admin status — admins get no shortcut. Make sure the player is:
- Clocked into the job bound to that business, and
- Standing inside the business zone, and
- Holding a manager grade for that job.
Set Config.debugConfig = true in cfg.lua to log whether a business is missing required points (for example, no zone placed).
Society banking isn’t receiving deposits
Sales deposit into the business’s society account through the backend set in Config.Society. If money isn’t landing:
- Confirm
Config.Society matches your framework — 'esx', 'qb', 'qbox', or 'external'.
- For
'external', confirm Config.BankingExport names a resource that exposes :handleTransaction and :addAccountMoney exports with the expected signature.
- Restart
nex_businesses after editing cfg.lua.
See Configuration for the full banking options.
Disabling the offline shop
The offline shopkeeper ped system has a server-wide kill switch:
Config.DisableOfflineShops = true
cfg.lua and restart the resource. No offline shop peds will spawn anywhere, regardless of what bosses have placed or stocked.
Editing config has no effect
cfg.lua and locales/* are the only editable files (the rest of the resource is escrow-protected). After editing either, restart the resource for the change to take effect.
Still stuck?
Open a ticket with your full server console output and a description of what you were doing when it broke. See Support. 
