Configuration

Page dedicated to how to configure our Police MDT [V2]

Languages

You can set the language of the script in the configuration file.

• en-US: English

• fr-FR: French

• pl-PL: Polish

• de-DE: German

• es-ES: Spanish

• pt-PT: Portugese

• ja-JP: Japanese

• es-IT: Italian

• ko-KR: Korean

Config.Locale = "en-US"

Commands & Keybinds

General

• /mdtlspd (DELETE): Toggle the MDT Dashboard.

• /qfmdtbadge (B): Show/Hide Officer Badge.

Camera Mode

• /qfmdtpolicecapturephoto (ENTER / SPACE): Take a photo.

• /qfmdtpolicecameratogglefocus (L-ALT / RMB): Toggle mouse focus.

• /qfmdtpolicecameratoggleflashlight (F): Toggle camera flashlight.

• /qfmdtpolicecameratoggleside (R): Switch between Front/Back camera.

Radar

• /qfmdtradartoggle (U): Toggle the entire Radar system.

• Front Radar Settings

  • /qfmdtradarshowfront (F5): Show Front Radar.

  • /qfmdtradarhidefront (F6): Hide Front Radar

  • /qfmdtradartoggleinteractfront (PGUP): Lock/Unlock Front Radar target

• Back Radar Settings

  • /qfmdtradarshowback (F7): Show Back Radar.

  • /qfmdtradarhideback (F8): Hide Back Radar

  • /qfmdtradartoggleinteractback (PGDN): Lock/Unlock Back Radar target

Note: All keys are configurable in config.lua.

Configuring Ranks (Grades)

config.lua, the Config.Grades table controls the hierarchy visible in the MDT. This must match your framework's job grades (ESX/QBCore/QBOX) to ensure correct label display.

-- config.lua
Config.Grades = {    
    {id = 0, name = "Cadet"},     
    {id = 1, name = "Officer I"},    
    {id = 2, name = "Officer II"},    
    {id = 3, name = "Sergeant"},    
    {id = 4, name = "Lieutenant"},    
    {id = 5, name = "Chief"}
}
-- Ensure 'id' corresponds to the grade integer in your database.

2. Customizing Fines

You can add new categories and fines in Config.FineList.

-- config.lua
Config.FineList = {    
    {        
        id = "1", -- Unique Category ID        
        label = "Traffic Laws",        
        items = {            
            {                    
                id = "1",                 
                label = "Speeding (> 50 km/h)",                 
                fine = 500,                 
                jail = 0 -- Optional: Jail time in months/minutes            
            },            
            {                
                id = "2",                 
                label = "Reckless Driving",                 
                fine = 1000,                 
                jail = 5            
            }        
        }    
    }
}

3. Dispatch Colors & Vehicles

The dispatch system uses specific color codes for vehicles. These are defined in Config.Dispatch.Colors. When creating custom alerts, you can use these or standard RGB values.

---

Server-side Exports

Use these exports in your other resources to interact with the MDT backend.

AddLog

Adds an entry to the Audit Log. Useful for tracking evidence locker access, armory usage, or boss menu actions.

Syntax:

exports.qf_mdt_police_v2:AddLog(source, tag, text, color, fields, args)

Parameters:

Parameter	Type	Description
source	number	Player Source ID.
tag	string	Category tag (e.g., 'armory', 'evidence', 'boss').
text	string	Log message.
color	string	Color theme ('blue', 'red', 'green', 'orange').
fields	table	(Optional) Key-value pairs for extra metadata.
args	table	(Optional) Arguments for translation if text is a locale key.

Example (Armory Usage):

-- Triggered when a player withdraws a weapon
local weaponName = "WEAPON_PISTOL"
local ammoCount = 50

exports.qf_mdt_police_v2:AddLog(    
    source,     
    "armory",     
    "Withdrew weapon from armory",     
    "red",     
    {         
        weapon = weaponName,         
        ammo = ammoCount,        
        serialNumber = "WX-12345"     
    }
)

---

Client-side Exports

Use these exports to integrate the MDT UI and systems with other scripts (e.g., Robbery scripts, Radar systems).

CreateDispatchAlert

Triggers a dispatch notification for all on-duty police.

Syntax:

exports.qf_mdt_police_v2:CreateDispatchAlert(coords, title, description, code, colorRGB, maxOfficers, duration)

Parameters:

Parameter	Type	Description
coords	vector3	Location of the alert.
title	string	Alert Header.
description	string	Detailed info (e.g., street name, vehicle info).
code	string	10-Code (e.g., '10-90').
colorRGB	table	{r, g, b} format.
maxOfficers	number	(Optional) flashing limit of units.
duration	number	(Optional) Time in ms the alert stays on screen.

Example (Bank Robbery):

-- Triggered when a player starts hacking a vault
local plyPed = PlayerPedId()
local coords = GetEntityCoords(plyPed)
local streetName = GetStreetNameFromHashKey(GetStreetNameAtCoord(coords.x, coords.y, coords.z))

exports.qf_mdt_police_v2:CreateDispatchAlert(
    coords,    
    "Bank Robbery in Progress",    
    "Silent alarm triggered at " .. streetName .. " Fleeca Bank.",    
    "10-90",    
    {255, 0, 0}, 
    15, 
    10000
)

showOfficerBadge

Displays the badge ID card on screen.

Syntax:

exports.qf_mdt_police_v2:showOfficerBadge(data)

Data Structure:

{    
    name = "Officer Name",    
    badge = "Badge Number",    
    gradeLabel = "Rank Name",    
    mugshot = "URL to image (optional)",    
    licenses = {        
        { label = "Weapon License", active = true },        
        { label = "Driving License", active = false }    
    }
}

Example:

exports.qf_mdt_police_v2:showOfficerBadge(
{    
    name = "Robert Smith",    
    badge = "9921",    
    gradeLabel = "Chief of Police",    
    licenses = {        
        { label = "Advanced Driving", active = true },        
        { label = "SWAT Tactics", active = true }    
    }
})

AddHeistZone (Map)

Adds a visual zone to the live map, useful for ongoing robberies.

Syntax:

exports.qf_mdt_police_v2:AddHeistZone(zoneData)

Example:

exports.qf_mdt_police_v2:AddHeistZone({    
    id = "pacific_standard",    
    name = "Pacific Standard Robbery",    
    position = { x = 255.2, y = 210.0 }, 
    radius = 60.0,    street = "Vinewood Blvd",    
    thumbnailUrl = "https://example.com/bank-image.jpg"
})

RemoveHeistZone

Removes a heist zone when the event is over.

Example:

exports.qf_mdt_police_v2:RemoveHeistZone("pacific_standard")

---

Camera & Radar Exports

Bodycam

Control the immersion overlays.

exports.qf_mdt_police_v2:showBodycam()

exports.qf_mdt_police_v2:hideBodycam()

Radar

Control the vehicle radar system programmatically.

-- Force show front radar
exports.qf_mdt_police_v2:showRadar("front") 

-- Manually update radar data (e.g. for a tutorial or scripted event)
exports.qf_mdt_police_v2:setRadarData("front", {    
    plate = "FAKE-123",    model = "Buffalo",    speed = 150,    speedDisplay = "km/h"
})

Dispatch Integrations & Custom Alerts

Compatibility

Enable 3rd party script compatibility by editing config/config.lua.

-- Enable external dispatch scripts in config/config.lua
Config.Dispatch = {
    Integration = {
        rcore_dispatch = true, -- Set to true to automatically bridge alerts
        core_dispatch = false,
        opto_dispatch = false,
        tk_dispatch = false
    }
}

Custom Alerts

Control and send dispatch alerts to the MDT programmatically.

-- Send a custom dispatch alert manually from any server script
TriggerEvent('qf_mdt_police_v2/server/addCustomDispatch', {
    id = "custom_robbery_123",        -- (Optional) Unique ID, system generates one if empty
    title = "Store Robbery",          -- Alert title/name
    code = "10-90",                   -- Dispatch code
    color = {255, 0, 0},              -- RGB color table or HEX string (e.g., "#FF0000")
    street = "Route 68",              -- (Optional) Street name or location description
    x = 100.5,                        -- X coordinate of the alert
    y = -213.2,                       -- Y coordinate of the alert
    z = 32.5,                         -- Z coordinate of the alert
    max_officers = 6,                 -- (Optional) Maximum officers that can react (default: 10)
    duration = 5000                   -- (Optional) Duration the alert stays on screen in ms (default: 5000)
})