ai-policealert para desarrolladores
Cómo enviar una alerta policial que llegue a ai-policealert (o a cualquier otro script de alertas), los campos de DispatchAlert y el export propio de ai-policealert.
Para enviar una alerta policial desde tu script, llama a dispatch.alert(alert) de la lib (TypeScript) o a aiLib.dispatch.alert(alert) (Lua). Pasa por la capa de dispatch de AI Core y llega al sistema de alertas que use el servidor: ai-policealert, o un script de alertas de terceros soportado. Nunca llames directamente al export de ai-policealert.
dispatch.alert
Envía una alerta de policía (o de otro trabajo) a través de AI Core. La reciben los miembros de servicio de jobs; sin jobs, los trabajos de policía propios del sistema de alertas (para ai-policealert: los Alert jobs del panel).
Lado: Servidor · Espera: no
dispatch.alert(alert: DispatchAlert): booleanlocal sent = aiLib.dispatch.alert(alert) -- booleanParámetros
Prop
Type
DispatchAlert
Prop
Type
Devuelve
true cuando un sistema de alertas aceptó la alerta. false cuando no hay ningún sistema de alertas en marcha o la alerta no es válida (sin title).
Ejemplo
import { dispatch, onClientCallback } from "@aicore-fivem/lib/server";
import { Locale } from "./locale"; // los textos traducidos de tu recurso
// Un cliente dice que ha empezado a forzar un cajero; el servidor alerta a la policía en la posición del jugador.
onClientCallback("myscript:breakAtm", (source) => {
const sent = dispatch.alert({
code: "10-90",
title: Locale("ALERT_ATM_TITLE"),
message: Locale("ALERT_ATM_MESSAGE"),
source, // las coordenadas salen de este jugador
icon: "money-bill",
priority: "high",
});
if (!sent) console.log("no alert system is running");
return { ok: true };
});Los textos se muestran tal como los envías: tradúcelos antes de la llamada. Los campos que no aparecen arriba se descartan. No envíes una alerta por cada acción repetida: ai-police, por ejemplo, mantiene una alerta por disparos cada 150 m cada 30 s.
Export de servidor
DispatchAlert
El punto de entrada propio de ai-policealert. Solo lo llama la capa de dispatch de AI Core mientras ai-policealert es el sistema de alertas activo; los scripts usan dispatch.alert de arriba. Tipado como AiPoliceAlertServerExports en @aicore-fivem/shared.
Lado: Servidor · Espera: no
DispatchAlert(alert: DispatchAlert): voidexports['ai-policealert']:DispatchAlert(alert)Parámetros
Prop
Type
Devuelve
Nada. Llamarlo directamente se salta la elección del sistema de alertas de AI Core, y coords no se rellena a partir de source (AI Core lo hace antes de llamar al export).
Eventos privados
El contrato servidor-cliente propio del script (resource/common/alerts.ts). Pueden cambiar entre versiones: no los dispares ni los escuches desde otros recursos.
| Nombre | Dirección | Qué transporta |
|---|---|---|
ai-policealert:client:alerts | servidor -> agente | Las alertas activas del trabajo de servicio del agente (una lista completa; una lista vacía borra las tarjetas). |
ai-policealert:client:alert | servidor -> agente | Una alerta nueva. |