Troubleshooting

Common issues and solutions for Echo Development scripts.

General Issues

Script not starting

Problem

Resource fails to start or shows errors in the server console.

Solutions:

Make sure the resource folder name matches exactly (case-sensitive) — e.g. NR_EmoteMenu, NR_PoliceJob, NR_Tablet
Check that ensure ResourceName is in your server.cfg
All dependencies must start before the Echo 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

Problem

Console shows errors about missing exports or resources not found.

Solutions:

Verify all required dependencies are installed — most scripts require your framework (es_extended, qb-core, or qbx_core), ox_lib, and an inventory system
Ensure dependencies are started before Echo scripts in server.cfg
NR_DJ also requires xsound — add ensure xsound before that resource
NR_PoliceJob requires a target system (ox_target or qb-target) and auto-detects your dispatch system (ps-dispatch, cd_dispatch, qs-dispatch, core_dispatch, or origen_police)
Check the individual script's documentation page for its full dependency list

Framework not detected

Problem

Console shows "Framework not found" or similar errors.

Solutions:

All scripts now use Config.Framework = 'auto' by default, which auto-detects your framework (checks for qbx_core → qb-core → es_extended)
If auto-detection fails, manually set Config.Framework to 'esx', 'qb', or 'qbx'
Ensure your framework resource starts before Echo scripts in server.cfg
Restart your entire server rather than just the resource

Items not showing in inventory

Problem

Script items (harness, lockpick, tablet, USB keys, dirty money, etc.) don't appear in the player inventory.

Solutions:

Add the item definitions to your inventory system (ox_inventory/data/items.lua or qb-core/shared/items.lua) — see each script's documentation for both formats
Add the item images to your inventory resource's image folder
Restart your inventory system 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 washing_machine, black_money, advanced_lockpick, and suspicious_package items are added

ox_target interactions not appearing

Problem

No interaction prompts show up when looking at NPCs, objects, or target zones.

Solutions:

Ensure your target system (ox_target or qb-target) is installed and started before the Echo 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

Problem

SQL errors appear in the console when starting a resource.

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_DJ: No audio playing

⚠️ Common Issue

Audio-based scripts require xsound to be installed and started before the Echo resource.

Install xsound if you haven't already
Add ensure xsound before ensure NR_DJ in your server.cfg
Verify you have access to the booth (check job/gang restrictions in config.lua)

NR_EmoteMenu: Menu not opening

Press F5 or use the /em command
Verify the web/dist/ folder exists and contains built files
Check the F8 console for errors
Ensure Config.menuKey is set to a valid key in config.lua

NR_PoliceJob: No dispatch notifications

The script auto-detects your dispatch system (ps-dispatch, cd_dispatch, qs-dispatch, core_dispatch, or origen_police)
Ensure your dispatch resource is started and running
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 your target system and inventory system 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 your target system and inventory system are running
Verify framework notifications are working

NR_MoneyWash: Washing not starting

Ensure the player has both the washing_machine and black_money items
Check that items are properly defined in your inventory system (ox_inventory/data/items.lua or qb-core/shared/items.lua)
Verify ox_lib is running for progress bar functionality

Recommended server.cfg Order

Dependency Load Order

Dependencies must start before Echo scripts. Here is a recommended order:

# Your framework (use ONE of these):
ensure es_extended   # ESX
# ensure qb-core     # QBCore
# ensure qbx_core    # QBX/Qbox

ensure oxmysql
ensure ox_lib
ensure ox_inventory   # or your inventory system
ensure ox_target      # or qb-target
ensure xsound

ensure NR_PoliceJob
ensure NR_Harness
ensure NR_PawnShop
ensure NR_EmoteMenu
ensure NR_DJ
ensure NR_MailBoxes
ensure NR_MoneyWash
ensure NR_Tablet
ensure NR_Towing

Enabling Debug Mode

Most Echo 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 Echo 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