FAQ

Frequently asked questions and troubleshooting guide for the God-Impound system.

❓ General Questions

Q: Which frameworks does God-Impound support?

A: God-Impound supports three major frameworks:

  • ESX (es_extended)

  • QBCore (qb-core)

  • Qbox (qbox_core)

You can switch between them by changing J0.Core in the config file.


Q: Do I need any additional resources?

A: Yes, the following resources are required:

  • ox_lib - For UI and menu systems

  • oxmysql - For database operations

  • screenshot-basic - For camera functionality

Optional but recommended:

  • ox_inventory or qb-inventory - For camera item integration


Q: Is the script optimized for performance?

A: Yes, God-Impound is optimized for server performance:

  • Uses efficient database queries

  • Minimal resource usage

  • Optimized UI rendering

  • Efficient vehicle detection system


Q: Can I use this script on multiple servers?

A: This depends on your license agreement. Please refer to your purchase terms and conditions.


🔧 Installation Questions

Q: The resource won't start. What should I check?

A: Check the following:

  1. Dependencies:

  2. Framework:

    • Verify your framework (ESX/QBCore/Qbox) is installed and running

    • Check that J0.Core matches your framework

  3. Console Errors:

    • Check server console for specific error messages

    • Look for missing files or syntax errors

  4. File Structure:

    • Ensure all files are in the correct locations

    • Verify fxmanifest.lua is present


Q: I'm getting database errors. How do I fix this?

A: Follow these steps:

  1. Verify SQL execution:

    • Make sure you ran runme.sql in your database

    • Check that table impound_vehicles exists

  2. Check database connection:

    • Verify oxmysql is configured correctly

    • Test database connection in oxmysql config

  3. Check table structure:

    • Ensure all required columns exist

    • Verify column types match the SQL schema

  4. Permissions:

    • Check database user has CREATE, INSERT, UPDATE, DELETE permissions


Q: The camera isn't working. What's wrong?

A: Troubleshooting steps:

  1. Check screenshot-basic:

    • Verify it's installed and started

    • Check for errors in console

  2. Verify image logging:

    • Check J0.ImageLogService is set correctly

    • Verify J0.ImageLogs contains valid webhook/API key

    • Test webhook URL in browser (should show "Invalid webhook" if URL is wrong)

  3. Check camera item:

    • Verify item is added to inventory correctly

    • Check item image path is correct

    • Ensure item export/useable is configured

  4. Test command:

    • Try /camerasshow command directly

    • Check if camera UI appears


⚙️ Configuration Questions

Q: How do I change the impound location?

A: Edit J0.ImpoundPedCoords in config.lua:

Finding coordinates:

  1. Go to desired location in-game

  2. Use /tp command or coordinate tool

  3. Note X, Y, Z coordinates

  4. Face desired direction and note heading (0-360)

Example:


Q: Can I add more impound laws?

A: Yes! Edit J0.Laws in config.lua:

Important:

  • Use unique IDs

  • Keep IDs sequential for organization

  • Provide clear titles and descriptions


Q: How do I change the police job name?

A: Edit J0.PolJobName in config.lua:

Common job names:

  • "police" - Default

  • "lspd" - Los Santos Police Department

  • "bcso" - Blaine County Sheriff's Office

Make sure it matches exactly how it appears in your framework's job system.


Q: Can I add more vehicle spawn points?

A: Yes! Add more entries to J0.VehicleSpawnCoords:

The system randomly selects from available spawn points.


🎮 Usage Questions

Q: Players can't see the impound menu. Why?

A: Check these:

  1. Job verification:

    • Player must have the job matching J0.PolJobName

    • Verify job name is correct in config

  2. Command usage:

    • Ensure player types /impound correctly

    • Check for typos

  3. Resource status:

    • Verify God-Impound is running

    • Check for errors in console

  4. Permissions:

    • Some servers require players to be "on duty"

    • Check your server's job system requirements


Q: Vehicles aren't being impounded. What's wrong?

A: Troubleshooting:

  1. Distance check:

    • Player must be within 20 units of vehicle

    • Get closer to the vehicle

  2. Plate matching:

    • Ensure plate entered matches vehicle plate exactly

    • Check for typos or spaces

  3. Vehicle ownership:

    • Script only impounds owned vehicles

    • Verify vehicle is in database (player_vehicles/owned_vehicles)

  4. Progress bar:

    • Don't cancel the progress bar

    • Wait for completion


Q: How does automatic release work?

A: The system automatically checks impound times every 60 seconds:

  1. Server checks all impounded vehicles

  2. Compares impoundUntil date with current time

  3. If time has passed:

    • Updates vehicle state in database

    • Removes from impound_vehicles table

    • Vehicle becomes available again

Note: Players don't need to do anything - it's automatic.


Q: Can civilians retrieve their own vehicles?

A: Currently, only police officers can retrieve vehicles through the system. This is by design for roleplay purposes.

Workaround: You could modify the script to add civilian access, but this requires code changes.


Q: The proof image isn't showing. Why?

A: Check these:

  1. Image logging:

    • Verify J0.ImageLogs is configured

    • Test webhook/API connection

    • Check if images are being uploaded

  2. Database:

    • Verify image URL is saved in database

    • Check impound_vehicles.image column

  3. UI:

    • Check browser console for image loading errors

    • Verify image URL is accessible


🐛 Technical Issues

Q: I'm getting "ox_lib not found" error.

A: Install ox_lib:

  1. Download from: https://github.com/overextended/ox_lib

  2. Place in resources folder

  3. Add to server.cfg: ensure ox_lib

  4. Restart server


Q: Script works but vehicles don't spawn correctly.

A: Check spawn configuration:

  1. Coordinates:

    • Verify spawn points are valid

    • Test coordinates in-game

    • Ensure Z coordinate is correct (not underground)

  2. Rotation:

    • Check rotation values (0-360)

    • Ensure vehicles spawn facing correct direction

  3. Collision:

    • Make sure spawn points aren't blocked

    • Clear area if needed


Q: Database queries are slow.

A: Optimization tips:

  1. Indexes:

    • Add index on plate column (usually auto with PRIMARY KEY)

    • Consider index on impoundUntil for time checks

  2. Cleanup:

    • Regularly clean old impound records

    • Remove expired impounds manually if needed

  3. Database:

    • Ensure proper database configuration

    • Check MySQL/MariaDB performance settings


🔒 Security Questions

Q: Can players exploit the impound system?

A: The script includes security measures:

  • Job verification for all commands

  • Server-side validation

  • Database checks for vehicle ownership

  • Distance checks for impound actions

Additional security:

  • Consider adding admin-only commands for manual overrides

  • Monitor impound logs for suspicious activity

  • Set up Discord webhook logging for audit trail


Q: How do I prevent abuse?

A: Recommendations:

  1. Permissions:

    • Only give police job to trusted players

    • Use server management tools to monitor

  2. Logging:

    • Enable Discord webhook logging

    • Review impound records regularly

  3. Rules:

    • Set clear server rules for impound usage

    • Enforce consequences for abuse


📞 Still Need Help?

If you can't find the answer to your question:

  1. Check documentation:

    • Installation Guide

    • Configuration Guide

    • Commands Guide

  2. Check console:

    • Look for specific error messages

    • Note any Lua errors

  3. Contact support:

    • Reach out to the developer

    • Provide error messages and steps to reproduce

Last updated