Common issues#
- The hub does not open. Check that glitch-uiElements is started before glitch-racing and that the three items exist in ox_inventory. The console prints a message when glitch-uiElements is missing or not started.
- No VR spot. Check
Config.VRZones. The target is an ox_target box, so ox_target must be running. - Players cannot enter the creator. They need the licence set in
Config.Permissionsor the matching ACE. The street creator also opens for staff and for players on the creator access list in the staff hub. - The Track Creator option is missing at the VR spot. It uses the glitch-admin role gate
racing.creator. SetConfig.Integrations.creatorRoleDefaultto your own role names and keep glitch-admin running. - A track fails to save. It is over
Config.Creator.maxTrackBytes, overConfig.Race.maxPropsPerTrackor over 500 checkpoints, or the player is atmaxTracksPerPlayer. - Thumbnails stay on the old link. Copying needs sd-phone and
Config.Creator.mirrorThumbnails = true. Check the server console. - The phone app is missing. The player needs the
racing_usbitem, or setConfig.Street.item = false. sd-phone must be running, and withdefaultApp = falsethe app is installed from the App Store. - Props are invisible in the creator. The server does not stream that prop. Set
Config.Debug = trueto list the missing models. - No prize after a race. Solo races refund the entry and pay nothing. Check
minPlayersForPayout. Tokens also respecttokenCooldownSecondsandtokenMinRaceSeconds. - A prize did not arrive. If the payout failed or the driver was offline, it waits in
glitch_racing_pendingand is paid at their next login. - Race cars vanish on spawn. Leave
Config.Buckets.lockdownat'inactive'. The value'relaxed'blocks client script entities and deletes every race car. - Licences stay low. Without glitch-xpSystem only wins count. With it, a tier needs both the level and the wins.
- The wheel does nothing. Wheel support is off by default and needs the helper program on the player's PC. Set
Config.Wheel.enabled = trueand have the player run/wheelsetup.
Updating safely#
Back up config.lua and the glitch_racing_* tables. Merge new keys from the new config into yours, add any new items, restart dependencies first and then glitch-racing.
Getting help#
Include the resource version, your qbx_core and ox_inventory versions, reproduction steps and the relevant server and F8 errors in a support ticket.
Stuck on a step?Ask in the Discord →