Crear llamada dedespacho

Envía alertas de dispatch en FiveM desde cualquier script con qs-dispatch: 35 exports de robos y delitos, el evento CreateDispatchCall y opciones de blips.

Sección: 34.3
Leer: 4 min
Actualizado: 1 nov

■ 4 min read · Actualizado 1 nov 2026

Cualquier script de tu servidor puede enviar una alerta al dispatch: un robo a una tienda, una venta de drogas, una alarma de banco, una solicitud de grúa. Hay dos formas de hacerlo — llamar a una de las 35 alertas listas para usar con un solo export, o crear tu propia llamada con el evento qs-dispatch:server:CreateDispatchCall.

Alertas listas para usar#

Cada alerta es un export de cliente sin argumentos. Envía una llamada a la policía en la posición actual del jugador, con el código, el mensaje, el blip y el icono correctos. Llámala desde el cliente del jugador que comete el delito:

lua

-- client side, in your robbery script
exports['qs-dispatch']:StoreRobbery()

Export	Código	Alerta
`Hunting`	10-13	Hunting
`VendingDrugs`	10-15	Vending Drugs
`VehicleShooting`	10-16	Vehicle Shooting
`Shooting`	10-17	Shooting
`OfficerDown`	10-18	Officer Down
`SpeedingVehicle`	10-20	Speeding Vehicle
`Fight`	10-21	Fight
`InjuriedPerson`	10-22	Injured Person
`DeceasedPerson`	10-23	Deceased Person
`StoreRobbery`	10-24	Store Robbery
`FleecaBankRobbery`	10-25	Fleeca Bank Robbery
`PaletoBankRobbery`	10-26	Paleto Bank Robbery
`PacificBankRobbery`	10-27	Pacific Bank Robbery
`PrisonBreak`	10-28	Prison Break
`VangelicoRobbery`	10-29	Vangelico Robbery
`HouseRobbery`	10-30	House Robbery
`DrugSale`	10-31	Drug Sale
`ArtGalleryRobbery`	10-32	Art Gallery Robbery
`HumaneRobery`	10-33	Humane Labs Robbery
`TrainRobbery`	10-34	Train Robbery
`VanRobbery`	10-35	Van Robbery
`UndergroundRobbery`	10-36	Underground Robbery
`DrugBoatRobbery`	10-37	Drug Boat Robbery
`UnionRobbery`	10-38	Union Depository Robbery
`YachtHeist`	10-39	Yacht Heist
`CarBoosting`	10-40	Car Boosting
`CarJacking`	10-41	Car Jacking
`VehicleTheft`	10-42	Vehicle Theft
`SuspiciousActivity`	10-43	Suspicious Activity
`IllegalRacing`	10-44	Illegal Racing
`Kidnapping`	10-45	Kidnapping
`CyberAttack`	10-46	Cyber Attack
`IllegalFishing`	10-47	Illegal Fishing
`ArmsDeal`	10-48	Arms Deal
`SignRobbery`	10-49	Sign Robbery

Todas están escritas en client/custom/exports/exports_1.lua, que puedes editar: cambia un mensaje, envíala también al sheriff o copia una para crear un export propio.

Enviar tu propia llamada#

Para todo lo que no esté en la lista, dispara el evento de servidor qs-dispatch:server:CreateDispatchCall con una tabla que describa la llamada. Lo habitual es hacerlo en el cliente: lee la posición y el vehículo del jugador con GetPlayerInfo, opcionalmente toma una foto con getSSURL y luego envía la llamada.

lua

local playerData = exports['qs-dispatch']:GetPlayerInfo()

exports['qs-dispatch']:getSSURL(function(image)
    TriggerServerEvent('qs-dispatch:server:CreateDispatchCall', {
        job = { 'police', 'sheriff' },
        callLocation = playerData.coords,
        callCode = { code = '10-90', snippet = 'ATM Robbery' },
        message = 'A ' .. playerData.sex .. ' is breaking into an ATM on ' .. playerData.street_1,
        flashes = true,
        image = image,
        blip = {
            sprite = 108,
            scale = 1.2,
            colour = 1,
            flashes = true,
            text = 'ATM Robbery',
            time = (5 * 60 * 1000), -- 5 minutes
        },
        otherData = {
            { text = 'Armed suspect', icon = 'fas fa-gun' },
        }
    })
end)

lua

local playerData = exports['qs-dispatch']:GetPlayerInfo()

TriggerServerEvent('qs-dispatch:server:CreateDispatchCall', {
    job = 'mechanic',
    callLocation = playerData.coords,
    callCode = { code = 'Tow', snippet = 'Breakdown' },
    message = 'A ' .. playerData.vehicle_label .. ' (' .. playerData.vehicle_plate .. ') has broken down',
    flashes = false,
    blip = {
        sprite = 68,
        scale = 1.0,
        colour = 5,
        flashes = false,
        text = 'Tow request',
        time = (3 * 60 * 1000),
    }
})

Desde un script de servidor, usa TriggerEvent. Los exports de servidor leen los datos del jugador desde su cliente, así que llámalos dentro de un thread:

lua

CreateThread(function()
    exports['qs-dispatch']:GetPlayerInfo(source, function(playerData)
        TriggerEvent('qs-dispatch:server:CreateDispatchCall', {
            job = { 'police' },
            callLocation = playerData.coords,
            callCode = { code = '10-31', snippet = 'Alarm' },
            message = 'Silent alarm triggered at the warehouse',
            flashes = true,
            blip = {
                sprite = 161, scale = 1.5, colour = 1, flashes = true,
                text = 'Silent alarm', time = (2 * 60 * 1000),
            }
        })
    end)
end)

Los campos de la llamada#

Campo	Tipo	Descripción
`job`	string o tabla	Obligatorio. Quién la recibe: `'police'` o `{ 'police', 'sheriff' }`. Cada trabajo también debe estar en `Config.JobsAllowed`.
`callLocation`	vector3	Obligatorio. Dónde ocurrió. Debe ser un `vector3`, no una tabla — `playerData.coords` ya lo es.
`callCode`	tabla	`{ code = '10-24', snippet = 'Store Robbery' }` — el código y su título corto en la tarjeta de la llamada.
`message`	string	La descripción que leen los agentes.
`flashes`	boolean	Resalta la tarjeta de la llamada como urgente.
`image`	string o nil	Una URL de imagen que se muestra en la llamada — normalmente el resultado de `getSSURL`.
`blip`	tabla	El blip del mapa — ver abajo. Omítelo para una llamada sin blip.
`otherData`	tabla	Líneas extra en la tarjeta, cada una `{ text = '...', icon = 'fas fa-...' }` con un icono de Font Awesome. Debe ser una lista, incluso con una sola línea.

El blip#

Campo	Descripción
`sprite`	El id del icono del blip de la lista de blips de FiveM.
`scale`	Su tamaño — 1.0 es el normal.
`colour`	El id del color del blip (1 es rojo).
`flashes`	Hace que el blip parpadee.
`text`	El nombre que se muestra en la leyenda del mapa.
`time`	Cuánto tiempo permanece, en milisegundos. Se desvanece gradualmente durante ese tiempo.

Qué devuelve GetPlayerInfo#

exports['qs-dispatch']:GetPlayerInfo() describe al jugador que lo llama, listo para incluir en un mensaje:

Campo	Contiene
`coords`	La posición del jugador, como vector3.
`street_1` · `street_2`	El nombre de la calle y el nombre de la zona de `config/datas.lua`.
`sex`	"Male" o "Female" según el idioma activo, o "person" cuando no se puede saber.
`vehicle`	La entidad del vehículo, o nil si va a pie.
`vehicle_label` · `vehicle_colour` · `vehicle_plate`	El nombre del modelo, el color y la matrícula — o `VehLabel Unknown` y similares cuando va a pie.
`speed`	La velocidad del vehículo en km/h.
`doorCount`	El número de puertas.
`ped` · `networkEntityId`	El ped del jugador y el network id del vehículo (0 a pie).

Las fotos necesitan un webhook. getSSURL devuelve nil cuando Config.AllowImages está desactivado o Config.DiscordWebHook está vacío — la llamada se envía igualmente, solo que sin imagen.

Reaccionar a cada llamada#

Cada llamada creada — por un comando, un export, el DLC o tu propio script — pasa por OnCallEvent en server/custom/events/onCallEvent.lua. Ya publica las llamadas de policía y EMS en Discord; añade ahí cualquier otra cosa — una notificación del teléfono, un log, un contador.

lua

function OnCallEvent(job, callLocation, callCode, message, flashes, image, callId)
    if Contains(job, 'police') then
        -- your code: SMS to every officer, a log, ...
    end
end

[··] Documentación

Cargandola guía