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-photosThe screenshot-basic resource must be started before xeno-photos.
Verify database connection:
Check that
oxmysqlis properly configuredEnsure 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.MaxImageSizeTry lowering your game resolution temporarily
Increase
Config.MaxImageSizein config.lua if needed
Camera Not Working
Symptoms
/takephotocommand doesn't open cameraCamera 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
/takephotoEnsure 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
Gallery Not Loading
Symptoms
/openphotoopens empty galleryPhotos 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
/takephotoTry 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:
Enable debug mode and check console output
Check server console for errors
Test with minimal resources to rule out conflicts
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

