Troubleshooting

Common issues and solutions for NightRider's Development scripts.

General Issues

Script not starting

Solutions:

• Make sure the resource folder name matches exactly (case-sensitive) — e.g. NR_CarPlay, NR_PoliceJob, NR_Tablet
• Check that ensure ResourceName is in your server.cfg
• All dependencies must start before the NightRider resource in your server.cfg
• Check the F8 console and server console for specific error messages
• Try a full server restart rather than just restarting the resource

Dependencies not found

Solutions:

• Verify all required dependencies are installed — most scripts require qbx_core, ox_lib, and ox_inventory
• Ensure dependencies are started before NightRider scripts in server.cfg
• NR_CarPlay and NR_DJ also require xsound — add ensure xsound before those resources
• NR_PoliceJob requires ox_target and a dispatch system (configured for Kartik MDT by default)
• Check the individual script's documentation page for its full dependency list

Framework not detected

Solutions:

• Open config.lua and verify Config.Framework matches your framework — use 'qbx' for QBX Core or 'qb-core' for QBCore
• Verify Config.FrameworkFolder matches your framework's resource name (e.g. 'qbx_core' or 'qb-core')
• Ensure your framework resource starts before NightRider scripts in server.cfg
• Restart your entire server rather than just the resource

Items not showing in inventory

Solutions:

• Add the item definitions to ox_inventory/data/items.lua — see each script's documentation for exact item configs
• Add the item images to your inventory resource's image folder
• Restart ox_inventory after adding new items
• For NR_Tablet: ensure the tablet item and all USB key items (crew_usb, mdt_usb, boost_usb, house_usb, ug_usb) are added
• For NR_Harness: ensure the harness item is added
• For NR_MailBoxes: ensure the lockpick and reward items are added
• For NR_MoneyWash: ensure the dirtymoney and moneywash_machine items are added

ox_target interactions not appearing

Solutions:

• Ensure ox_target is installed and started before the NightRider resource
• Check that you are close enough to the interaction point
• Verify ox_lib is also running — many target interactions depend on it
• For NR_PoliceJob: make sure the player has the police job and is on duty
• For NR_PawnShop: verify the pawn shop location coordinates in config.lua

Database errors

Solutions:

• Import the SQL file included with the resource (if applicable)
• Make sure your database connection is configured correctly in server.cfg
• Check that you're not importing the SQL file twice (duplicate table errors)
• Ensure oxmysql is installed and started — required by scripts like NR_Harness

Script-Specific Issues

NR_CarPlay / NR_DJ: No audio playing

• Install xsound if you haven't already
• Add ensure xsound before ensure NR_CarPlay or ensure NR_DJ in your server.cfg
• NR_CarPlay uses YouTube URLs for music — make sure you're pasting a valid YouTube link
• For NR_DJ: verify you have access to the booth (check job/gang restrictions in config.lua)

NR_CarPlay: Dashboard not opening

• You must be inside a vehicle to open the dashboard
• Press F5 or use the /opendashboard command
• Ensure ox_lib is started before NR_CarPlay
• Check the F8 console for errors
• Enable Config.Debug = true in config.lua for detailed logs

NR_CarPlay: Backup camera not working

• The backup camera activates when the dashboard is open and you shift into reverse
• Use debug commands /backupcam and /camproximity to test functionality
• Check the F8 console for any proximity sensor errors

NR_PoliceJob: No dispatch notifications

• The script is configured for Kartik MDT by default — check the dispatch export on client.lua line 443
• If using a different MDT/dispatch, modify the export to match your system
• Verify the player has the police job and is on duty
• Automatic dispatches run every 15 minutes by default (Config.DispatchInterval)

NR_PoliceJob: Mission won't complete

• You must be within 50 meters of Bolingbroke Penitentiary
• The prisoner must be in the vehicle
• A minimum transport time of 10 seconds is required (anti-exploit)
• Missions auto-cancel after 30 minutes of inactivity
• There is a 60-second cooldown between manual mission starts

NR_PoliceJob: NPCs not spawning

• Ensure the NPC models in config.lua are valid
• Verify ox_target is running
• Check the spawn location coordinates in Config.SpawnLocations

NR_MailBoxes: Can't interact with mailboxes

• Check that the player has a lockpick item in their inventory
• Verify time restrictions aren't blocking the robbery (check Config.TimeRestriction)
• The mailbox may be on cooldown from a previous robbery
• Ensure ox_target and ox_inventory are both running

NR_Tablet: Apps not showing

• USB keys must be inserted into the dock — use the tablet and click "Insert Required Items"
• Verify the USB item is listed in Config.AllowedTabletItems in config.lua
• Check the HTML has the correct data-requires attribute for the app
• VMS Housing is always available without a USB — if it's not showing, check for NUI errors in F8

NR_Tablet: Tablet won't open

• Ensure the tablet item is properly added to ox_inventory/data/items.lua with the server export
• Verify ox_lib is started
• Enable Config.Debug = true for detailed logs in the F8 console

NR_Tablet: Items not saving in dock

• Verify the stash is configured in ox_inventory/data/stashes.lua
• Ensure the USB items are in the stash whitelist
• Restart ox_inventory after adding the stash configuration
• Non-whitelisted items are automatically removed and returned to the player

NR_Tablet: Custom app not working

• Check NR_Tablet/client/custom_apps.lua for your app logic
• Verify the export or event exists in the target script
• Ensure the app's icon is placed in NR_Tablet/web/assets/
• Check F8 console for errors when clicking the app

NR_Harness: Harness not equipping

• Ensure the harness item is added to ox_inventory/data/items.lua
• Player must be inside a vehicle to equip the harness
• Verify oxmysql is running for harness data storage

NR_PawnShop: Can't sell items

• Verify the pawn shop location coordinates in config.lua
• Check that sellable items are configured in Config.Items
• Ensure ox_target and ox_inventory are running
• Verify qbx_core notifications are working

NR_MoneyWash: Washing not starting

• Ensure the player has both the moneywash_machine and dirtymoney items
• Check that items are properly defined in ox_inventory/data/items.lua
• Verify ox_lib is running for progress bar functionality

Recommended server.cfg Order

ensure qbx_core
ensure oxmysql
ensure ox_lib
ensure ox_inventory
ensure ox_target
ensure xsound

ensure NR_PoliceJob
ensure NR_Harness
ensure NR_PawnShop
ensure NR_CarPlay
ensure NR_DJ
ensure NR_MailBoxes
ensure NR_MoneyWash
ensure NR_Tablet

Enabling Debug Mode

Most NightRider scripts include a debug option. Set Config.Debug = true in the script's config.lua to get detailed logs in the F8 console. This helps identify exactly where an issue is occurring.

Performance

• All NightRider scripts are optimized to run at 0.00-0.01ms
• Use resmon 1 in the F8 console to check resource performance
• If a script shows high usage, check for conflicts with other resources
• Ensure you're not running duplicate resources that handle the same functionality

Still Need Help?

If your issue isn't listed here:

• Join our Discord server for community support
• For paid scripts, open a support ticket for priority help
• When asking for help, include: server console errors, framework version, script version, and your server.cfg load order