Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Common issues

All common issues fixes here

Photos Not Saving

Symptoms

  • Photos appear to be taken but don't show up in gallery

  • No confirmation after taking photo

  • Gallery appears empty

Solutions

Check screenshot-basic installation:

# In server.cfg, ensure this order:
ensure screenshot-basic
ensure xeno-photos

The screenshot-basic resource must be started before xeno-photos.

Verify database connection:

  • Check that oxmysql is properly configured

  • Ensure database credentials are correct

  • Check console for SQL errors

Enable debug mode:

Restart the resource and check console for error messages that indicate the problem.

Check image size:

  • Very large screenshots may exceed Config.MaxImageSize

  • Try lowering your game resolution temporarily

  • Increase Config.MaxImageSize in config.lua if needed

Camera Not Working

Symptoms

  • /takephoto command doesn't open camera

  • Camera opens but controls don't respond

  • Camera position is frozen

Solutions

Check for resource conflicts:

  • Disable other camera/screenshot resources temporarily

  • Look for console errors when running /takephoto

  • Ensure no other resources are blocking native camera functions

Force reset:

This emergency command resets the camera state.

Restart the resource:

Check keybind conflicts:

  • Make sure other resources aren't blocking WASD/QE controls

  • Try arrow keys for rotation if mouse doesn't work

UI Stuck or Not Closing

Symptoms

  • UI remains visible after exiting camera

  • Cannot interact with game while UI is open

  • ESC doesn't close the interface

Solutions

Use force close command:

This immediately closes the UI and restores normal gameplay.

Check for JavaScript errors:

  • Open browser console (F8 → click "Console" tab)

  • Look for errors in the NUI/HTML console

  • Report any errors to support

Resource restart:

No Console Output

Symptoms

  • No debug messages in console

  • Cannot see photo processing status

  • Silent errors

Solutions

Enable debug mode:

Restart the resource:

Check console filters:

  • Make sure your server console isn't filtering out messages

  • Look for [xeno-photos] prefixed messages

Symptoms

  • /openphoto opens empty gallery

  • Photos exist in database but don't display

  • Gallery UI appears but shows nothing

Solutions

Check database:

Verify photos exist in the database.

Use test command:

This shows your identifier and connection status.

Check identifier format:

  • Ensure your framework's identifier system matches what's being stored

  • License identifiers should start with license:

Clear and retry:

  • Try taking a new photo

  • Check if new photos appear in gallery

  • Older photos may have data issues

Discord Webhook Not Working

Symptoms

  • Photos save but no Discord notification

  • Webhook errors in console

  • Imgur upload fails

Solutions

Verify webhook URL:

Check Imgur configuration:

Follow the Installation guide to get a valid Imgur Client ID.

Test the webhook:

  • Use a webhook testing tool to verify the URL works

  • Check Discord server permissions

  • Ensure webhook hasn't been deleted

Review Discord rate limits:

  • Discord limits webhook requests

  • If taking many photos quickly, some may not post

Performance Issues

Symptoms

  • FPS drops while in camera mode

  • Lag when taking photos

  • Server performance degradation

Solutions

Reduce image size:

Disable unnecessary features:

Lower game settings:

  • Reduce resolution before taking photos

  • Screenshots are captured at native resolution

Check server resources:

  • Ensure adequate database performance

  • Monitor server load during photo captures

Filter Not Applying

Symptoms

  • Clicking filter has no effect

  • Filter preview doesn't show

  • All filters look the same

Solutions

Toggle UI:

  • Press ENTER to hide/show UI

  • This refreshes the filter preview

Wait for preview:

  • Some filters need a moment to apply

  • Don't click multiple filters rapidly

Restart camera:

  • Exit camera mode and reopen with /takephoto

  • Try the filter again

Check game timecycle:

  • Some other resources may override timecycle modifiers

  • Disable conflicting resources

Getting Help

If your issue isn't listed here:

  1. Enable debug mode and check console output

  2. Check server console for errors

  3. Test with minimal resources to rule out conflicts

  4. Provide details:

    • Exact error messages

    • Steps to reproduce

    • Server framework (QBCore/ESX/Standalone)

    • List of other camera/photo resources

Support

Still having issues? Join the Discord for support.

Last updated