Troubleshooting

MDT Won't Open

Problem: "You do not have access to the MDT"

Solution:

  1. Check your job name is in Config.AllowedJobs

  2. Verify you're on duty (if your server requires it)

  3. Ensure the resource has started without errors

Problem: MDT opens but shows blank pages

Solution:

  1. Verify SQL was imported correctly:

    • QBCore: sql/pf-policemdt-qb.sql

    • ESX: sql/pf-policemdt-esx.sql

  2. Confirm oxmysql is running and connected

  3. Check server console for database connection errors

  4. Verify database credentials in your server configuration

Dispatch Issues

Problem: Calls show but no dispatch notification sound

Solution:

  1. Ensure Config.DispatchNotifications.Enabled = true

  2. Restart the resource: restart pf-policemdt

  3. If using native sound, try different sound names in Config.DispatchNotifications.Sound

Problem: /911 command does nothing

Solution:

  1. Verify Config.Dispatch911.Enabled = true

  2. Check cooldown: Config.Dispatch911.CooldownSeconds

  3. Review server console for errors

CCTV Issues

Problem: CCTV page is empty, no cameras found

Solution:

  1. Verify Config.CCTV.Enabled = true

  2. Ensure Config.CCTV.AutoDiscover = true

  3. Stand near CCTV props (must be loaded in) and wait for discovery

  4. Check that pf_mdt_cctv_cameras table exists in database

Evidence & Screenshots

Problem: Screenshots aren't working

Solution:

  1. Verify screenshot-basic is installed and started before the MDT

  2. Check server.cfg startup order

  3. Confirm screenshot folder permissions

Database Errors

Problem: "Database connection failed" errors

Solution:

  1. Verify oxmysql is started before the MDT

  2. Check database credentials in server.cfg

  3. Confirm MySQL/MariaDB server is running

  4. Verify database user has proper permissions

  5. Test database connection manually with your SQL client

Performance Issues

Problem: MDT is laggy or causes FPS drops

Solution:

  1. Switch to tile map mode: Config.Map.mode = 'tiles'

  2. Reduce Config.CCTV.RecordingInterval if CCTV is heavy

  3. Disable unused integrations in config.lua

  4. Check server resources (status command)

Missing Data

Problem: Searches return no results for citizens/vehicles

Solution:

  1. Verify correct SQL was imported

  2. Create some test characters in-game

  3. Ensure player data exists in your framework's tables

  4. Check that MDT job has proper permissions


Support & Help

When reporting issues, please provide:

  1. Your config.lua (remove webhook URLs first)

  2. Server console output (status command for resources)

  3. Client-side errors (press F8 in-game)

  4. Steps to reproduce the issue

  5. Confirmation of correct SQL import


Next Steps

After installation:

  1. Test the MDT: Open it via command, keybind, or item

  2. Configure permissions: Adjust job names and grades in config.lua

  3. Set up integrations: Enable any optional scripts you use

  4. Test features: Create dispatch calls, search records, view CCTV

  5. Customize: Adjust map mode, colors, and UI settings


Congratulations! Your Police MDT is now installed and ready to use.

Last updated