Studios
Storeshouse-3.jpg

Installation

SoonStoresQbox
PAGE 02 OF 07  ·  OVERVIEW → INSTALLATION → CONFIGURATIONdocs.glitchstudios.dev
Browse docs

Requirements#

The server

Framework qbx_core (Qbox). ESX and plain QBCore are not supported.
Resources ox_lib, ox_target, ox_inventory 2.48.0 with install/ox_inventory-2.48.0.patch applied
Server A FiveM server artifact with OneSync.
Database None.
Optional glitch-uiElements (button sounds and a local copy of the Tabler icon font), glitch-poolcleaning (net event counts, see Config.NetGuard), a GlobalState table with a live tax rate (Config.Tax.stateKey)

Tested with qbx_core 1.24.0, ox_inventory 2.48.0, ox_lib 3.40.0 and ox_target 1.17.2.

Without the patch the resource still starts. ox_inventory shops keep their normal window, the price surge is off and the server console prints one error at start. OpenBusiness and OpenCustom stores work without it.

Installation steps#

  1. Put the glitch-stores folder in your resources folder. The folder name is case-sensitive: ox_inventory and other resources call it as glitch-stores.

  2. Patch ox_inventory. From the ox_inventory folder run:

    git apply --check ../path/to/glitch-stores/install/ox_inventory-2.48.0.patch
    git apply ../path/to/glitch-stores/install/ox_inventory-2.48.0.patch
    

    The patch has LF line endings and is written against a clean ox_inventory 2.48.0. If your copy has Windows (CRLF) line endings, add --ignore-whitespace to both commands. git apply also works in a folder that is not a git repository. The ox_inventory Patch page lists what it changes.

  3. There are no items, SQL files or images to install. Item pictures come from ox_inventory's image folder.

  4. Add to server.cfg, after ox_lib, qbx_core, ox_inventory and ox_target:

    ensure glitch-uiElements
    ensure glitch-stores
    

    Leave out glitch-uiElements if you do not use it.

  5. Set Config.Currency and Config.Tax in config/main.lua, and check Config.Clerks.FoodJobs in config/clerks.lua. The price surge is on out of the box for a job called burgershot.

  6. Restart the server and target a 24/7 clerk. The ox_target option is called Open Shop. If the console says ox_inventory is missing the glitch-stores exports, the patch is not applied.

The resource has no commands, so it needs no ACE permissions.

[!WARNING] With the default config, water, sprunk, coffee and sandwiches cost 4x in 24/7s while anyone in the burgershot job is on duty. Set Config.Clerks.FoodJobs to your own restaurant's job name, or to {}, before you start the resource.

Updating#

Keep your config/main.lua, config/clerks.lua and locales/ files, replace everything else, and compare your config with the new defaults in the CHANGELOG. Restart glitch-stores.

Updating ox_inventory replaces the patched files. Check whether a newer install/ox_inventory-<version>.patch ships with glitch-stores before you update, and follow the ox_inventory Patch page to apply it again.