Studios
Racinghouse-3.jpg

Troubleshooting

SoonRacingQbox
PAGE 05 OF 06  ·  EXAMPLES → TROUBLESHOOTING → COMMANDS & EXPORTSdocs.glitchstudios.dev
Browse docs

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.Permissions or 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. Set Config.Integrations.creatorRoleDefault to your own role names and keep glitch-admin running.
  • A track fails to save. It is over Config.Creator.maxTrackBytes, over Config.Race.maxPropsPerTrack or over 500 checkpoints, or the player is at maxTracksPerPlayer.
  • 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_usb item, or set Config.Street.item = false. sd-phone must be running, and with defaultApp = false the app is installed from the App Store.
  • Props are invisible in the creator. The server does not stream that prop. Set Config.Debug = true to list the missing models.
  • No prize after a race. Solo races refund the entry and pay nothing. Check minPlayersForPayout. Tokens also respect tokenCooldownSeconds and tokenMinRaceSeconds.
  • A prize did not arrive. If the payout failed or the driver was offline, it waits in glitch_racing_pending and is paid at their next login.
  • Race cars vanish on spawn. Leave Config.Buckets.lockdown at '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 = true and 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.