ps-mdt v3

Police MDT (Mobile Data Terminal) for FiveM. Built with Svelte 5 and Lua. Works on QBCore and QBX through the ps_lib abstraction layer.

What is this

A full in-game law enforcement computer. Officers press F11 or type /mdt to open it. From there they can look up citizens, write reports, manage cases, track evidence, issue warrants, run BOLOs, look up vehicles and weapons, view security cameras and bodycam feeds, handle dispatch, and manage their department. Everything is permission-based so you control exactly what each rank has access to.

Dependencies

These need to be running on your server:

Resource	Why
ps_lib	Framework abstraction layer
oxmysql	Database
ox_lib	Utility library
screenshot-basic	Mugshot capture

Optional but HIGHLY RECOMMENDED:

Resource	Why
ps-dispatch	Dispatch integration

Installation

No backwards compatibility with ps-mdtv1.

1. Import the database

Run sql/qbcore.sql against your FiveM database. This creates all the tables the MDT needs. Use phpMyAdmin, HeidiSQL, or whatever database tool you prefer.

2. Set your FiveManage API keys

Image uploads (mugshots, evidence photos, suspect photos) and activity log forwarding go through FiveManage. You need API keys from their site.

Add these lines to your server.cfg:

set ps_mdt_fivemanage_key_images "YOUR_IMAGES_API_KEY_HERE"
set ps_mdt_fivemanage_key_logs   "YOUR_LOGS_API_KEY_HERE"

Convar	What it does
ps_mdt_fivemanage_key_images	Used for uploading mugshots, evidence photos, and suspect photos
ps_mdt_fivemanage_key_logs	Used for forwarding audit trail activity to FiveManage Logs

Both are optional. Without the images key you won't be able to upload any images. Without the logs key the audit trail still works locally in the database, it just won't forward to FiveManage.

3. Build the frontend

If you grabbed a release with web/dist already in it, skip this step.

Otherwise:

cd resources/[qb]/ps-mdt/web
npm install
npm run build

4. Add to server.cfg

ensure ps_lib
ensure oxmysql
ensure ox_lib
ensure ps-mdt

ps-mdt has to start after its dependencies.

Configuration

All config lives in config.lua.

Jobs

Which jobs can access the MDT:

Config.PoliceJobType = "leo"
Config.PoliceJobs = { 'lspd', 'bcso', 'sahp', 'fib', 'gov' }

Config.DojJobType = "doj"
Config.DojJobs = { 'doj', 'lawyer' }

Config.MedicalJobType = "ems"
Config.MedicalJobs = { 'ambulance' }

Keybind and command

Config.OnlyShowOnDuty = true   -- false = can open off duty

Config.Keys = {
    OpenMDT = {
        enabled = true,
        key = 'F11',
    },
}

Config.Commands = {
    Open = { enabled = true, command = 'mdt' },
    MessageOfTheDay = { enabled = true, command = 'motd' },
}

Data sharing between departments

Config.Sharing = {
    -- All these departments see each other's data
    Mutual = {
        types = { 'reports', 'bodycams', 'evidence', 'bolos', 'warrants' },
        departments = { 'lspd', 'bcso', 'sahp' }
    },

    -- FIB/GOV can see patrol data but patrol can't see theirs
    OneWay = {
        {
            viewers = { 'fib', 'gov' },
            targets = { 'lspd', 'bcso', 'sahp' },
            types = { 'reports', 'bodycams', 'evidence', 'bolos', 'warrants' }
        },
    },
}

Impound locations

Config.ImpoundLocations = {
    [1] = vector4(409.09, -1623.37, 29.29, 232.07),  -- LSPD
    [2] = vector4(-436.42, 5982.29, 31.34, 136.0),   -- Paleto
}

Other stuff worth changing

Setting	Default	What it does
Config.Fines.MaxAmount	100000	Cap on fine amounts
Config.Fines.CooldownMs	30000	Cooldown between fines (ms)
Config.Warrants.DefaultExpiryDays	7	Days until a warrant expires
Config.RegisterWeaponsAutomatically	true	Auto-register weapons on purchase
Config.RegisterCreatedWeapons	false	Auto-register crafted weapons
Config.UseWolfknightRadar	true	Wolfknight plate reader integration
Config.UseCQCMugshot	true	CQC mugshot trigger
Config.Fuel	'LegacyFuel'	Your fuel resource name
Config.Debug	false	Debug logging

Preview

Features

Citizens

Look up any player. See their name, photo, gender, DOB, phone, fingerprint, job, vehicles, properties, arrest count, and linked reports. Edit licenses, add tags, upload photos, and take mugshots.

Reports

Write incident reports with a rich text editor. Add suspects, victims, officers, charges, and evidence. Tag and restrict reports by department or rank.

Cases

Group related reports into investigations. Assign officers, set priority and status, attach files, track everything in one place.

Evidence

Register evidence with type, serial, and location. Upload photos, track chain of custody, transfer between officers, link to cases and reports.

Warrants

Issue warrants with expiry dates. Track felony/misdemeanor/infraction counts. Close them when served.

BOLOs

Be On Lookout alerts for people and vehicles. Set status, share across departments.

Vehicles

Search by plate, view registration and owner, manage DMV records. Handle impounds with configurable lot locations.

Weapons

Firearm registry with serial tracking and ownership history.

Security Cameras

Place cameras around the map (23 prop models available). View feeds with pan, zoom, and FOV controls.

Bodycams

Watch live feeds from on-duty officers.

Dashboard

Stats overview: reports this week vs last week, active units, job info.

Dispatch

View and respond to dispatch calls. Hooks into ps-dispatch.

Roster

All officers with duty status, callsign, and department.

Leaderboard

Rankings by arrests, reports, and activity.

Charges

Manage penal codes and charge definitions. Create, edit, and categorize charges by class (felony, misdemeanor, infraction) with configurable fines, jail time, and points.

Awards

Recognize officers with department awards. Track commendations and achievements on officer profiles.

Internal Affairs (IA)

File and manage internal affairs complaints against officers. Track complaint status through investigation stages (Open, Under Investigation, Investigated, Sustained, Exonerated, Unfounded, Closed). Includes a standalone complaint form accessible via /complaint command or export for civilian-facing resources. IA complaints appear in officer profiles under the IA History tab.

PPR (Performance Planning & Review)

Create performance reviews for officers covering coachable moments, commendations, and developmental feedback. Supervisors can document incidents from cases, traffic stops, or any notable officer conduct. PPR records are tied to officer profiles and accessible from both the Personnel sidebar and the officer's profile PPR tab.

Management

Admin panel for the department. Set permissions per rank, post bulletins, view audit logs, manage tags. There are 25 permissions you can assign per role covering citizens, BOLOs, vehicles, weapons, cases, evidence, reports, warrants, charges, dispatch, cameras, bodycams, notes, and management access.

Audit Trail

Every action gets logged. Who did what, when. Covers: logins, reports, cases, evidence, warrants, vehicles, weapons, charges, searches, dispatch, officers, sentencing, arrests, ICU. Each category toggles on/off from the settings page.

Exports

For other resources to interact with the MDT.

Client Exports

Export	Parameters	Returns	Description
OpenMDT	—	—	Opens the MDT interface for the current player
CloseMDT	—	—	Closes the MDT and restores player controls
IsMDTOpen	—	boolean	Returns whether the MDT is currently open
IsLEOJob	jobName: string?	boolean	Checks if a job is law enforcement. If no argument is passed, checks the current player's job
isViewingCamera	—	boolean	Returns whether the player is currently viewing a security camera feed
openComplaint	—	—	Opens the standalone IA complaint form (works outside the MDT, useful for civilian resources)
openCivilianMDT	—	—	Opens the MDT in civilian mode (profile + legislation view only). Use from phone apps, courthouse scripts, etc.

Server Exports

Export	Parameters	Returns	Description
IsCidFelon	citizenid: string, cb: function?	boolean	Checks if a citizen has any felony charges on record. Supports both callback and direct return
isRequestVehicle	vehicleId: number	boolean	Checks if a vehicle was flagged for impound via the MDT. Consumes the entry on match
registerWeapon	citizenid: string, weaponName: string, serial: string, info: string?	—	Registers a weapon in the MDT firearms registry with ownership history