Studios
Tebexhouse-3.jpg

Installation

SoonTebexQbox
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, oxmysql, ox_target, ox_inventory
Vehicle products qbx_vehicles, only if you sell vehicles. It is server-only, so it is not in the manifest dependencies.
Tebex A Tebex webstore and the game server secret key from the Tebex panel.
Database MariaDB or MySQL through oxmysql. The tables are created when the resource starts.
Server setting OneSync enabled.

Optional resources

Each one is detected at run time and has a switch in Config.Integrations. With the resource missing, the feature is skipped and nothing else breaks.

Switch Resource What it adds
admin glitch-admin Logs tab and a Discord log channel, plus Discord role tiers for memberships
xp glitch-xpSystem Server XP boost from the item and from My account. Without it boosts refuse to start
garages glitch-garages Business work van plates are refused at the Plate Studio
audioProps glitch-audioProps Supporter TVs for the tvs membership flag
charSlots qbx_multicharacter with the GrantPaidSlots, RevokePaidSlots and GetSlotInfo exports Paid and membership character slots
vehicleLock qbx_vehicles with the registerHook export Blocks transfers of store vehicles
phone sd-phone (name in Config.PhoneResource) Verified tick on Squawk and Photogram for members
hud glitch-hud and glitch-uiElements Hides the HUD and compass while the store is open

Stock Qbox does not have the qbx_multicharacter and qbx_vehicles exports listed above. The charSlots and vehicleLock switches only do something on a server that has them.

Installation steps#

  1. Put the glitch-tebex folder in your resources folder. The folder name is case-sensitive.

  2. If you use XP boosts, add the entry from install/items.txt to ox_inventory/data/items.lua and put an xpboost.png image in ox_inventory/web/images.

  3. Optionally run sql/install.sql. The tables are also created on first start, so this only matters if your database user cannot create tables.

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

    ensure glitch-tebex
    sv_tebexSecret "your-tebex-secret-key"
    
  5. Edit config.lua: set Config.Screen.standAt to a spot in front of a flat wall, then your store links and your packages.

  6. Add the Tebex commands to every package in the Tebex panel (see Tebex Setup).

  7. Restart the server and walk to the TV. The ox_target option opens the store.

[!NOTE] config.server.lua loads after config.lua and overrides it. Put your own values there, or leave it empty and edit config.lua directly. Both files stay open for editing.

Permissions#

The staff commands are restricted ox_lib commands, so each needs its own ace:

add_ace group.admin command.tebexorders allow
add_ace group.admin command.tebexdone allow
add_ace group.admin command.glitchtokens_give allow

Updating#

Replace everything except config.lua and config.server.lua, compare the new defaults with your copies, then restart the resource. Check CHANGELOG.md for anything new in the config.