Exports & API

Core Dispatch exposes exports on both server and client for integration with other scripts.

Server Exports

serverexports['core_dispatch']:sendAlert(data)

Send a fully customized alert to one or more departments. This is the most flexible way to create dispatch calls.

Parameter	Type	Description
data		Table with code, message, extraInfo, coords, priority, job, time, blip, color

Returns: nil

Example

exports['core_dispatch']:sendAlert({
    code = '10-71',
    message = 'Shots fired near Legion Square',
    extraInfo = {
        { icon = 'fa-venus-mars', info = 'Male suspect' },
    },
    coords = vector3(215.0, -810.0, 30.0),
    priority = false,
    job = 'police',
    time = 5000,
    blip = 156,
    color = 1,
})

serverexports['core_dispatch']:addCall(code, title, extraInfo, coords, job, cooldown, sprite, color, priority)

Add a standard call to the dispatch board with a code, title, and optional extra information.

Parameter	Type	Description
code		Call code (e.g. 10-71)
title		Call title text
extraInfo		Table of {icon, info} pairs
coords		Location vector3
job		Target job name or table of job names
cooldown		Display duration in ms
sprite		Blip sprite ID
color		Blip color ID
priority		Mark as urgent (true/false)

Returns: nil

Example

exports['core_dispatch']:addCall(
    '10-90', 'Store Robbery in Progress',
    {{ icon = 'fa-mask', info = 'Armed suspect' }},
    vector3(25.0, -1347.0, 29.0),
    'police', 5000, 156, 1, true
)

serverexports['core_dispatch']:addMessage(message, coords, job, cooldown, sprite, color, priority)

Add a message-type call to the dispatch board. Used for player-initiated calls like 911.

Parameter	Type	Description
message		Message text from caller
coords		Location vector3
job		Target job name
cooldown		Display duration in ms
sprite		Blip sprite ID
color		Blip color ID
priority		Mark as urgent (true/false)

Returns: nil

Example

exports['core_dispatch']:addMessage(
    'There is a fight outside the bank!',
    vector3(150.0, -1040.0, 29.0),
    'police', 5000, 480, 1, false
)

serverexports['core_dispatch']:sendShootingAlert(coords, gender)

Pre-built alert for shots fired. Sends Code 10-71 to police.

Parameter	Type	Description
coords		Location vector3
gender		Suspect gender string

Returns: nil

Example

exports['core_dispatch']:sendShootingAlert(
    GetEntityCoords(GetPlayerPed(source)), 'male'
)

serverexports['core_dispatch']:sendStoreRobbery(coords, gender)

Pre-built alert for store robberies. Sends Code 10-90 to police.

Parameter	Type	Description
coords		Location vector3
gender		Suspect gender string

Returns: nil

Example

exports['core_dispatch']:sendStoreRobbery(
    vector3(25.0, -1347.0, 29.0), 'female'
)

serverexports['core_dispatch']:sendBankRobbery(coords, gender)

Pre-built alert for bank robberies. Sends Code 10-90 to police.

Parameter	Type	Description
coords		Location vector3
gender		Suspect gender string

Returns: nil

Example

exports['core_dispatch']:sendBankRobbery(
    vector3(253.0, 228.0, 101.0), 'male'
)

serverexports['core_dispatch']:sendHouseRobbery(coords, gender)

Pre-built alert for house robberies. Sends Code 10-90 to police.

Parameter	Type	Description
coords		Location vector3
gender		Suspect gender string

Returns: nil

Example

exports['core_dispatch']:sendHouseRobbery(coords, 'male')

serverexports['core_dispatch']:sendCarjackAlert(vehicle, coords)

Pre-built alert for carjacking. Sends Code 10-35 to police with vehicle info.

Parameter	Type	Description
vehicle		Vehicle entity or model name
coords		Location vector3

Returns: nil

Example

exports['core_dispatch']:sendCarjackAlert(vehicle, GetEntityCoords(vehicle))

serverexports['core_dispatch']:sendCarTheftAlert(vehicle, coords)

Pre-built alert for vehicle theft from parking. Sends Code 10-35 to police.

Parameter	Type	Description
vehicle		Vehicle entity or model name
coords		Location vector3

Returns: nil

Example

exports['core_dispatch']:sendCarTheftAlert(vehicle, GetEntityCoords(vehicle))

serverexports['core_dispatch']:sendDrugSellAlert(coords, gender)

Pre-built alert for drug sales. Sends Code 10-13 to police.

Parameter	Type	Description
coords		Location vector3
gender		Suspect gender string

Returns: nil

Example

exports['core_dispatch']:sendDrugSellAlert(coords, 'male')

serverexports['core_dispatch']:sendInjuredPersonAlert(coords, gender)

Pre-built alert for injured civilians. Sends Code 10-69 to EMS.

Parameter	Type	Description
coords		Location vector3
gender		Person gender string

Returns: nil

Example

exports['core_dispatch']:sendInjuredPersonAlert(coords, 'female')

serverexports['core_dispatch']:sendOfficerDown(coords, gender)

Pre-built alert for officer down. Sends Code 10-99 to ALL departments as priority.

Parameter	Type	Description
coords		Location vector3
gender		Officer gender string

Returns: nil

Example

exports['core_dispatch']:sendOfficerDown(
    GetEntityCoords(GetPlayerPed(source)), 'male'
)

Client Exports

clientexports['core_dispatch']:sendAlert(code, message, coords, priority, job, extraInfo, time, blip, color)

Client-side version of sendAlert. Triggers a server event to create the dispatch call.

Parameter	Type	Description
code		Call code
message		Call message
coords		Location vector3
priority		Urgent flag
job		Target job(s)
extraInfo		Table of {icon, info} pairs
time		Duration in ms
blip		Blip sprite
color		Blip color

Returns: nil

Example

exports['core_dispatch']:sendAlert(
    '10-31', 'Suspicious activity reported',
    GetEntityCoords(PlayerPedId()),
    false, 'police',
    {{ icon = 'fa-eye', info = 'Witness report' }},
    5000, 480, 1
)

clientexports['core_dispatch']:openDispatch()

Programmatically open the dispatch menu UI.

Returns: nil

Example

exports['core_dispatch']:openDispatch()

clientexports['core_dispatch']:getPlayerCoords()

Get the current player's coordinates. Utility export for use in alert integrations.

Returns: vector3

Example

local coords = exports['core_dispatch']:getPlayerCoords()

clientexports['core_dispatch']:getPedGender(ped)

Returns the gender of a ped based on its model.

Parameter	Type	Description
ped		Ped entity handle

Returns: string

Example

local gender = exports['core_dispatch']:getPedGender(PlayerPedId())
-- Returns 'male' or 'female'