Commands and Exports

Commands and Exports — Dispatch and MDT | Quasar Store | Quasar Store

Commands#

The first five names are set in Config.Commands; the citizen commands live in client/custom/misc/commands.lua. Dispatch and MDT commands only work on duty with an allowed job.

Command	Who	Description
`/dispatch`	Allowed jobs	Opens the dispatch panel.
`/smalldispatch`

Default	Config	Does
L	`Config.Keys['OpenLargue']`	Open the dispatch panel.
K	`Config.Keys['OpenSmall']`	Show the small dispatch.
U	`Config.Keys['MoveSmall']`	Move the small dispatch.
← / →	`Config.MoveLeft` · `Config.MoveRight`	Previous and next call in the small dispatch.
G	`Config.Respond`	Respond to, or stop responding to, the call shown.
E	`Config.Penitencial.keyForSendToJail`	Send the charged suspects nearby to prison, at a booking point.

GetPlayerInfo — the player's position and vehicle

lua

local info = exports['qs-dispatch']:GetPlayerInfo()
-- info.coords, info.street_1, info.street_2, info.sex,
-- info.vehicle, info.vehicle_label, info.vehicle_colour, info.vehicle_plate,
-- info.speed, info.doorCount, info.ped, info.networkEntityId

Every field is described in Create Dispatch Call.

getSSURL — take a photo for a call

lua

exports['qs-dispatch']:getSSURL(function(url)
    -- url is the uploaded screenshot, or nil
end)

Captures the player's screen and uploads it to Config.DiscordWebHook. Returns nil when Config.AllowImages is off or no webhook is set. No extra screenshot resource is needed.

ToggleDuty and GetIsOnDuty — duty from another script

lua

exports['qs-dispatch']:ToggleDuty(true)   -- on duty
exports['qs-dispatch']:ToggleDuty(false)  -- off duty

if exports['qs-dispatch']:GetIsOnDuty() then
    -- ...
end

Call ToggleDuty from your duty or clock-in script so the dispatch follows it.

Opening the MDT from another script

lua

-- the current MDT, skipping the job check (like the item does)
TriggerEvent('qs-dispatch:client:OpenMdt')

-- the classic MDT (Config.MDT.newMdt = false)
exports['qs-dispatch']:TogleMdt(true)

TogleMdt is spelled with one g.

addCustomPage — add your own section to the MDT

Adds an entry to the MDT sidebar that shows any web page inside the MDT — your own NUI from another resource, or an external site.

lua

exports['qs-dispatch']:addCustomPage({
    title = 'Evidence',                                    -- the sidebar label
    image = 'https://example.com/evidence-icon.png',       -- the sidebar icon
    ui    = 'https://cfx-nui-my-evidence/web/index.html',  -- the page shown
})

All three fields are required; the export returns true when the page is added. Call it on the client after qs-dispatch has started.

GetPlayerInfo and GetSSURL — a player's data from the server

The same data as the client exports, read from a given player. Both wait for that player's client, so run them in a thread.

lua

CreateThread(function()
    exports['qs-dispatch']:GetPlayerInfo(playerId, function(info)
        print(info.street_1, info.vehicle_plate)
    end)

    exports['qs-dispatch']:GetSSURL(playerId, function(url)
        print(url)
    end)
end)

SendWebhook — post an embed to Discord

lua

exports['qs-dispatch']:SendWebhook(
    'https://discord.com/api/webhooks/...',  -- webhook URL
    'Sheriff Call',                          -- title
    '#c28a00',                               -- colour, as a hex string
    'A message for the log',                 -- description
    imageUrl                                 -- optional picture
)

Used by onCallEvent.lua for the call logs; reuse it for your own.

Event	Side	What it does
`qs-dispatch:server:CreateDispatchCall`	Server	Creates a dispatch call. Payload in Create Dispatch Call.
`qs-dispatch:client:OpenMdt`	Client	Opens the MDT, as using the item does.
`qs-dispatch:client:DeleteDiapatchCall`	Client	Removes a call by id, or every call with `'ALL'`. The name is spelled "Diapatch".
`qs-dispatch:client:fx:cameraFlash`	Client	Plays the speed-camera flash on the player's screen — useful for "caught on camera" moments.
`qs-dispatch:client:ReleaseFromJail`	Client	Closes the prison screen and plays the release scene. To release someone properly, use the MDT, which also clears the database.

lua

function OnCallEvent(job, callLocation, callCode, message, flashes, image, callId)
    if Contains(job, 'sheriff') then
        exports['qs-dispatch']:SendWebhook(SheriffWebhookURL, 'Sheriff Call', '#c28a00', message, image)
    end
end

Commands and Exports

Commands#

Keybinds#

Client Exports#

Server Exports#

Events#

Server Hook: OnCallEvent#