Requirements#
The server
| Framework | qbx_core (Qbox). ESX and plain QBCore are not supported. |
| Resources | ox_lib, oxmysql, ox_inventory, ox_target |
| Menus | glitch-uiElements (free Glitch Studios resource). It draws the hub, the car selector and the key hints. The console prints an error on start when it is missing or not started. |
| Database | MariaDB or MySQL 8. The tables are created on start. |
| Used when present | qbx_vehiclekeys (race cars get keys), qbx_density (open world traffic), Renewed-Weathersync (weather is handed back after a private race) |
| Optional | sd-phone, glitch-xpSystem, glitch-admin, glitch-arcade, glitch-mapHandler, glitch-treasury, glitch-shotMaker, glitch-pauseMenu, glitch-hud, glitch-audioProps |
The package was tested with qbx_core 1.24.0, ox_inventory 2.48.0, ox_lib 3.40.0, ox_target 1.17.2 and oxmysql 2.14.2.
Each optional resource is detected at run time and its feature is skipped when it is not running. Config.Integrations can switch each one off even when it runs. Without glitch-xpSystem, licence tiers are judged by wins alone.
Installation steps#
- Copy the
glitch-racingfolder into yourresourcesfolder. The name is case-sensitive and the manifest and exports expect exactlyglitch-racing. - Add the three items from
install/items.luatoox_inventory/data/items.lua:racing_headset,race_tokenandracing_usb. - The tables listed in
sql/glitch_racing.sqlare created when the resource starts. If your database user cannot create tables, run that file once by hand. - Add the resource to
server.cfgafter its dependencies:
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure ox_target
ensure glitch-uiElements
ensure glitch-racing
- Permissions. Staff come from the
adminACE, and frommodormoderator. To let a player use the creators without the matching licence, give them an ACE inserver.cfg:
add_ace identifier.license:YOUR_LICENSE glitch-racing.create allow
add_ace identifier.license:YOUR_LICENSE glitch-racing.stunt allow
- Open
config.luaand setConfig.VRZonesto where the VR Racing spot should be. It is an ox_target box. Players can also open the hub with the headset item. - Start the server, walk up to the spot or use the headset, and run a test race with a throwaway character.
Back up the database before the first install on a live server. The stunt creator stores whole tracks as JSON, and pot money moves through your framework.
Updating#
- Back up
config.luaand theglitch_racing_*tables first. - Replace the resource files, then merge any new keys from the new
config.luainto yours.config.lua, the locale file,sql/,install/and the README are not encrypted, so your edits stay readable. - Add any new items from
install/items.lua. - Restart the resource. Missing tables are created on start. Snap points taught in the stunt creator live in the resource KVP and are kept.
- Restart
glitch-racingafter restarting any of its dependencies.
Stuck on a step?Ask in the Discord →