Skip to main content

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.
ResourceMinimum version
oxmysql2.4.0
ox_lib3.2.1
ox_inventory2.30.7
ox_targetlatest
Plus one framework:
FrameworkResource
ESXes_extended (1.10+)
QBCoreqb-core
QBoxqbx_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

  1. 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.
  2. 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
    
  3. Open cfg.lua and set Config.Society to match your framework — 'esx', 'qb', or 'qbox'. See Configuration for the full list of options.
  4. 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.
  5. 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.