Server-Side Exports

🔌 Integration

This documentation outlines the server-side exports and events available for dots-dispatch. These allow you to trigger alerts from server-side scripts or manage responder data.

---

sendDispatch

The primary server-side export used to broadcast an alert to all players with specific jobs. It automatically assigns a unique global ID to the dispatch for tracking responders.

Arguments:

• data: (table) A collection of details defining the alert.

Parameters (data Table):

Parameter	Type	Description
jobs	table	List of job names authorized to receive this alert (e.g., {'police'}).
title	string	The main heading of the dispatch message.
code	string	(Optional) The dispatch or penal code (e.g., "10-90").
message	string	(Optional) Detailed description of the event.
coords	vector3	(Optional) Incident location; defaults to player position if nil.
blipData	table	(Optional) Settings for the map blip including sprite, color, and size (or radius for area blips).
sound	string	(Optional) Sound name to play on arrival; defaults to 'default'.
plate	string	(Optional) The license plate of a vehicle.

blipData: Parameters (data Table):

Parameter	Type	Description
sprite	int	The sprite set for the blip.
color	int	The color of the blip.
size	int	The size of a normal blip.
radius	int	The option to turn the blip into a radius.

💡 Example: Server-Side Robbery Alert

exports['dots-dispatch']:sendDispatch({
    jobs = { 'police' },
    title = 'Bank Robbery',
    code = '10-90',
    message = 'Vault alarm triggered at Pacific Standard',
    coords = vector3(253.0, 221.7, 101.6),
    blipData = {
        sprite = 156,
        color = 1,
        size = 1.0
    }
})