Requirements
Install these resources and make sure each meets the minimum version. The SQL schema is created automatically on first boot — there is nothing to import by hand.
| Resource | Minimum version |
|---|
oxmysql | 2.4.0 |
ox_lib | 3.2.1 |
ox_inventory | 2.30.7 |
ox_target | latest |
Plus one framework:
| Framework | Resource |
|---|
| ESX | es_extended (1.10+) |
| QBCore | qb-core |
| QBox | qbx_core |
The framework is auto-detected at boot, so you don’t set it anywhere — but you do need to point society banking at the right backend in cfg.lua (see Configuration).
object_gizmo is optional. It adds fine-grained placement handles in the setup tool. The resource starts fine without it.
Install steps
-
Drop the resource folder into your server’s resources directory.
The folder name must be exactly nex_businesses. The script registers events and exports under this name, and renaming the folder breaks them.
-
Add the resources to
server.cfg. Start your framework first, then the dependencies, then nex_businesses:
# one of these — whichever framework you run
ensure es_extended # ESX
# ensure qb-core # QBCore
# ensure qbx_core # QBox
ensure oxmysql
ensure ox_lib
ensure ox_inventory
ensure ox_target
ensure nex_businesses
-
Open
cfg.lua and set Config.Society to match your framework — 'esx', 'qb', or 'qbox'. See Configuration for the full list of options.
-
Start the server. The SQL tables are created automatically on first boot, and any new columns are migrated on upgrade. No manual import is needed.
-
As an admin (ACE-allowed), run
/createbusiness in-game and follow the prompts to register your first business and bind it to one of your framework’s jobs.
That’s it — no build steps, no npm, no compiling.
/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.
Next steps
- Setup tool — lay out the venue: zones, stations, registers, order counters, and the offline shop ped.
- Configuration — society banking, UI colors, and keybinds.