Browse docs

Emergency Dispatch

Public server-side exports for creating, checking, and removing Emergency Dispatch incidents.

Emergency Dispatch

These exports let server resources create Dispatch App incidents and manage incidents associated with their own source identifiers.

With Config.Dispatch.enabled = true, createDispatch creates a persistent Dispatch App incident. When the master switch is disabled, the same export automatically uses the legacy map dispatch and top-center notification.

`createDispatch(title, message, coords, jobs, meta)`

Argument	Type	Description
`title`	`string`	Required incident title.
`message`	`string`	Incident description.
`coords`	`vector3 \| table`	Required world position. Tables use `{ x, y, z }`.
`jobs`	`string \| string[]`	One job name or an array of target jobs.
`meta`	`table?`	Optional `source`, `sourceKey`, `sourceId`, and `category` values.

Returns: table | nil — the created dispatch entry, or nil when validation fails.

server.lua

local dispatch = exports["sky_jobs_base"]:createDispatch(
    "Bank Robbery",
    "Silent alarm triggered at Pacific Standard",
    vector3(235.0, 216.0, 106.0),
    "police",
    {
        source = source,
        sourceKey = "alarm",
        sourceId = "pacific-standard",
        category = "robbery"
    }
)

if dispatch then
    print("Dispatch created:", dispatch.id)
end

The returned entry contains id, title, message, coords, jobs, job, status, createdAt, and the supplied source metadata. Dispatch App incidents also expose an internal centerIncidentId; integrations should continue using their own sourceKey and sourceId.

`HasDispatch(sourceKey, sourceId)`

Checks whether a non-completed dispatch exists for the exact source key and ID pair.

Returns: boolean

server.lua

local exists = exports["sky_jobs_base"]:HasDispatch("alarm", "pacific-standard")

`RemoveDispatchesBySourceAndId(sourceKey, sourceId)`

Removes every matching dispatch and closes its linked Dispatch App incident.

Returns: number — the number of removed dispatches.

server.lua

local removed = exports["sky_jobs_base"]:RemoveDispatchesBySourceAndId(
    "alarm",
    "pacific-standard"
)

print("Removed dispatches:", removed)

Use a stable, resource-owned key and ID pair when you need duplicate prevention or later cleanup.

Server Exports

Server-side exports provided by sky_jobs_base for dispatch, tablet app registration, and more.

Client Events

Client-side events provided by sky_jobs_base that other resources can listen to.