Troubleshooting
MDT Won't Open
Problem: "You do not have access to the MDT"
Solution:
Check your job name is in
Config.AllowedJobsVerify you're on duty (if your server requires it)
Ensure the resource has started without errors
Problem: MDT opens but shows blank pages
Solution:
Verify SQL was imported correctly:
QBCore:
sql/pf-policemdt-qb.sqlESX:
sql/pf-policemdt-esx.sql
Confirm
oxmysqlis running and connectedCheck server console for database connection errors
Verify database credentials in your server configuration
Dispatch Issues
Problem: Calls show but no dispatch notification sound
Solution:
Ensure
Config.DispatchNotifications.Enabled = trueRestart the resource:
restart pf-policemdtIf using native sound, try different sound names in
Config.DispatchNotifications.Sound
Problem: /911 command does nothing
Solution:
Verify
Config.Dispatch911.Enabled = trueCheck cooldown:
Config.Dispatch911.CooldownSecondsReview server console for errors
CCTV Issues
Problem: CCTV page is empty, no cameras found
Solution:
Verify
Config.CCTV.Enabled = trueEnsure
Config.CCTV.AutoDiscover = trueStand near CCTV props (must be loaded in) and wait for discovery
Check that
pf_mdt_cctv_camerastable exists in database
Evidence & Screenshots
Problem: Screenshots aren't working
Solution:
Verify
screenshot-basicis installed and started before the MDTCheck
server.cfgstartup orderConfirm screenshot folder permissions
Database Errors
Problem: "Database connection failed" errors
Solution:
Verify
oxmysqlis started before the MDTCheck database credentials in
server.cfgConfirm MySQL/MariaDB server is running
Verify database user has proper permissions
Test database connection manually with your SQL client
Performance Issues
Problem: MDT is laggy or causes FPS drops
Solution:
Switch to tile map mode:
Config.Map.mode = 'tiles'Reduce
Config.CCTV.RecordingIntervalif CCTV is heavyDisable unused integrations in
config.luaCheck server resources (
statuscommand)
Missing Data
Problem: Searches return no results for citizens/vehicles
Solution:
Verify correct SQL was imported
Create some test characters in-game
Ensure player data exists in your framework's tables
Check that MDT job has proper permissions
Support & Help
When reporting issues, please provide:
Your
config.lua(remove webhook URLs first)Server console output (
statuscommand for resources)Client-side errors (press
F8in-game)Steps to reproduce the issue
Confirmation of correct SQL import
Next Steps
After installation:
Test the MDT: Open it via command, keybind, or item
Configure permissions: Adjust job names and grades in
config.luaSet up integrations: Enable any optional scripts you use
Test features: Create dispatch calls, search records, view CCTV
Customize: Adjust map mode, colors, and UI settings
Congratulations! Your Police MDT is now installed and ready to use.
Last updated