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#
Put the
glitch-tebexfolder in yourresourcesfolder. The folder name is case-sensitive.If you use XP boosts, add the entry from
install/items.txttoox_inventory/data/items.luaand put anxpboost.pngimage inox_inventory/web/images.Optionally run
sql/install.sql. The tables are also created on first start, so this only matters if your database user cannot create tables.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"Edit
config.lua: setConfig.Screen.standAtto a spot in front of a flat wall, then your store links and your packages.Add the Tebex commands to every package in the Tebex panel (see Tebex Setup).
Restart the server and walk to the TV. The ox_target option opens the store.
[!NOTE]
config.server.lualoads afterconfig.luaand overrides it. Put your own values there, or leave it empty and editconfig.luadirectly. 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.