🚓 QBX MDT System Documentation

The QBX MDT System is a law-enforcement Mobile Data Terminal built specifically for QBX-Core servers. It provides police with tools to manage civilians, vehicles, BOLOs, warrants, charges, and duty status through a clean in-game MDT interface.

📦 Overview

This script allows Law Enforcement to:

Search and view civilian records

Add notes, charges, and warrants

Search vehicles by plate

View vehicle owner information

Track BOLOs linked to vehicles

Clock in, go on break, and clock out

Access a configurable charge catalog

Use a secure, job-locked MDT UI

✅ Features

People search (name / citizenid)

Full citizen profiles

Notes & charge history

Warrants (create, view, clear)

Vehicle search by plate

Vehicle owner lookup

BOLO system (with plate support)

Duty clock system (in / break / out)

Job & grade restricted access

Charges pulled directly from config

Lightweight NUI interface

QBX-Core native player handling

📋 Requirements

Before installing, ensure your server has:

QBX-Core

ox_lib

oxmysql

Latest FiveM artifacts (recommended)

📁 Installation

Place the resource in your server resources folder:

resources/[police]/qbx-mdt

Add the following to your server.cfg in this order:

ensure oxmysql
ensure ox_lib
ensure qbx-core
ensure qbx-mdt

⚠️ ox_lib must be ensured before qbx-mdt or the MDT will not function.

Restart your server after ensuring the resource.

🧑‍✈️ Allowed Jobs

Only configured law enforcement jobs can access the MDT.

Configured in:

shared/config.lua

Example:

Config.AllowedJobs = {
    police = true,
    sheriff = true,
    state = true
}

🎖 Minimum Job Grade

You can restrict MDT access by job grade:

Config.MinGrade = 0

Examples:

0 → All officers

2 → Supervisors and above

4 → Command staff only

🔍 Search Limits

Control how many results return in searches:

Config.MaxResults = 25

Applies to:

Person search

Vehicle search

📑 Charges Configuration

All charges used by the MDT are defined in the config.

Example:

Config.Charges = {
    {
        code = "PC-101",
        label = "Speeding",
        category = "Traffic",
        fine = 250,
        jail = 0
    },
    {
        code = "PC-301",
        label = "Robbery",
        category = "Felony",
        fine = 5000,
        jail = 25
    }
}

Charges appear in:

Charges reference tab

Add-charge dropdown

Citizen charge history

🕒 Duty Clock System

Officers can manage duty status directly from the MDT:

Clock In

Break (IRL pause)

Clock Out

Duty status is saved server-side and updates live in the UI.

🔐 Access Control

MDT access is job-locked

Grade-restricted if configured

Unauthorized players cannot open or interact with the MDT

📜 Usage Notes

MDT is opened server-side via an event

Intended for Police / LEO use only

No EMS, dispatch, or court systems included

Designed to integrate cleanly with existing QBX servers

💬 Support & Custom Development

Need help integrating this MDT with:

Your vehicle system

A custom police framework

Additional features or UI changes

Support and custom development available through Legendary Development.