🔍 Troubleshooting

Common issues and how to fix them.

Enable Debug Mode

First, enable debug mode to see detailed errors:

Config.Debug = true

Check server console (not F8) for debug messages.

Common Errors

"attempt to index a nil value"

Cause: Missing dependency or framework not detected.

Fix:

1. Ensure ox_lib and oxmysql are installed
2. Ensure they start before akilla-donator
3. Check framework is properly installed

"No such export"

Cause: Resource not started or name mismatch.

Fix:

1. Verify resource is started
2. Check resource name is exactly akilla-donator
3. Restart the resource

Database errors

Cause: Database not connected or tables missing.

Fix:

1. Check oxmysql connection string
2. Run the SQL setup file
3. Verify database user permissions

UI not appearing

Cause: NUI build issue or script error.

Fix:

1. Check F8 console for errors
2. Verify html folder exists
3. Clear browser cache: F8 → setr nui_devmode 1

Target not working

Cause: Target resource not detected.

Fix:

1. Set interaction system explicitly:

Config.Interaction = {
    system = 'ox_target', -- or 'qb-target'
}

Tebex commands not working

Cause: Command format or server connection.

Fix:

1. Verify server is connected in Tebex
2. Check command format exactly matches
3. Test with a $0 test package

Vehicles not spawning

Cause: Invalid spawn location or missing keys.

Fix:

1. Check spawn location is accessible
2. Verify key system is detected
3. Check for errors in console

Keys not given

Cause: Key system not detected.

Fix:

1. Set key system explicitly:

Config.Vehicles = {
    keySystem = 'qb-vehiclekeys',
}

Performance Issues

High resource usage

1. Disable debug mode
2. Check for loops in custom code
3. Reduce number of shop items

Store loads slowly

1. Optimize image URLs
2. Use smaller image sizes
3. Check network connection

Getting More Help

If you can't resolve your issue:

1. Check the FAQ
2. Join our Discord (opens in a new tab)
3. Provide debug logs when asking for help