Trabajos y servicios

import { dispatch, prison, mdt, ems, medical, stress, needs, definitions, isPrimeTime } from "@aicore-fivem/lib/server";

Cada objeto de esta página pasa por una de las capas de ai-core: responde el script que usa el servidor para esa tarea (un sistema de alertas, una prisión, un MDT, un script de muerte, un HUD). Tu script sigue funcionando cuando el dueño lo cambia. Mientras no haya un script así en marcha, las llamadas fallan en silencio (false, 0, null).

dispatchCopy Anchor Link

dispatch.alertCopy Anchor Link

Envía una alerta a la policía (o a otro trabajo). El sistema de alertas la muestra a los miembros de servicio de jobs, por defecto los trabajos de policía.

Lado: Servidor · Espera: no

dispatch.alert(alert: DispatchAlert): boolean

local ok = aiLib.dispatch.alert(alert)

DispatchAlertCopy Anchor Link

El tipo es DispatchAlert.

DevuelveCopy Anchor Link

boolean: true cuando se envió. false cuando no hay sistema de alertas en marcha o la alerta no es válida.

EjemploCopy Anchor Link

import { dispatch, coordsOf, createLocale } from "@aicore-fivem/lib/server";

const Locale = createLocale();

function storeRobbed(source: number, store: string) {
  dispatch.alert({
    code: "10-90",
    title: Locale("ALERT_STORE_ROBBERY"),
    message: store,
    coords: coordsOf(source),
    source,
    icon: "store",
    priority: "high",
  });
}

prisonCopy Anchor Link

Condenas de prisión a través de ai-core, sea cual sea el script de prisión que funcione.

prison.jailCopy Anchor Link

Envía a prisión a un jugador cargado.

Lado: Servidor · Espera: no

prison.jail(source: number, minutes: number, by?: number): boolean

local ok = aiLib.prison.jail(source, minutes, by)

Devuelve true cuando se encarceló, false mientras no haya prisión en marcha.

if (!prison.jail(target, 15, officer)) return fail("NO_PRISON");

prison.releaseCopy Anchor Link

Deja salir a un jugador encarcelado.

Lado: Servidor · Espera: no

prison.release(source: number): boolean

local ok = aiLib.prison.release(source)

Devuelve true cuando se liberó, false cuando no está encarcelado o no hay prisión en marcha.

prison.release(target);

prison.timeLeftCopy Anchor Link

Lado: Servidor · Espera: no

prison.timeLeft(source: number): number

local minutes = aiLib.prison.timeLeft(source)

Devuelve los minutos de condena que quedan, 0 cuando está libre.

if (prison.timeLeft(source) > 0) return fail("IN_PRISON");

mdtCopy Anchor Link

Registros policiales del MDT (multas, órdenes de búsqueda, arrestos, cárcel) a través de la capa de MDT de ai-core. No se escribe nada mientras no haya MDT en marcha.

mdt.recordCopy Anchor Link

Escribe un registro en el MDT policial.

Lado: Servidor · Espera: no

mdt.record(record: MdtRecord): boolean

local ok = aiLib.mdt.record(record)

MdtRecordCopy Anchor Link

El tipo es MdtRecord.

Devuelve true cuando se escribió, false cuando no hay MDT en marcha o este no acepta ese tipo de registro.

if (prison.jail(target, 20, officer)) mdt.record({ kind: "jail", target, by: officer, title: "Armed robbery", minutes: 20 });

mdt.providerCopy Anchor Link

Lado: Servidor · Espera: no

mdt.provider(): string | null

local name = aiLib.mdt.provider()

Devuelve el MDT al que van los registros, o null.

if (!mdt.provider()) console.log("no MDT: records are skipped");

emsCopy Anchor Link

Médicos a través de la capa de EMS de ai-core: el recuento y las llamadas de auxilio propios de un script de EMS, o si no, los recuentos de servicio y las alertas de ai-core.

ems.availableCopy Anchor Link

Cuántos médicos están libres para atender una llamada.

Lado: Servidor · Espera: no

ems.available(jobs: string[]): number

local count = aiLib.ems.available(jobs)

Devuelve el número de médicos de servicio en jobs, dejando fuera a los ocupados cuando un script de dispatch los conoce.

// Deja a los jugadores reaparecer en el hospital solo cuando ningún médico puede venir.
const canRespawn = ems.available(["ambulance"]) === 0;

ems.distressCopy Anchor Link

Envía una llamada de auxilio para un jugador a los médicos de call.jobs.

Lado: Servidor · Espera: no

ems.distress(source: number, call: DistressCall): boolean

local ok = aiLib.ems.distress(source, call)

El tipo es DistressCall.

Devuelve true cuando algo aceptó la llamada, false en caso contrario.

if (!ems.distress(source, { jobs: ["ambulance"], message: "Unconscious" })) return fail("NO_MEDICS");

ems.providerCopy Anchor Link

Lado: Servidor · Espera: no

ems.provider(): string | null

local name = aiLib.ems.provider()

Devuelve la fuente de EMS que usa la capa, "ai-core" para sus propios recuentos de servicio.

console.log(`medics through ${ems.provider()}`);

medicalCopy Anchor Link

Revivir, curar y el estado de derribado a través de la capa médica de ai-core, sea cual sea el script de muerte o de ambulancia que funcione. Sin equivalente en Lua: llama a los exports de ai-core RevivePlayer, HealPlayer, IsPlayerDead.

medical.reviveCopy Anchor Link

Levanta a un jugador derribado donde está tendido.

Lado: Servidor · Espera: no

medical.revive(source: number): boolean

Devuelve true cuando se revivió, false cuando no está derribado o no hay script de muerte en marcha.

if (!medical.revive(target)) return fail("NOT_DOWN");

medical.healCopy Anchor Link

Da la salud completa a un jugador que no está derribado.

Lado: Servidor · Espera: no

medical.heal(source: number): boolean

Devuelve true cuando se curó, false cuando no hay script de muerte en marcha.

medical.heal(source);

medical.isDeadCopy Anchor Link

Si el jugador está derribado.

Lado: Servidor · Espera: no

medical.isDead(source: number): boolean

Devuelve true cuando está derribado; false sin script de muerte. Úsalo en lugar de leer la salud del ped.

if (medical.isDead(source)) return fail("YOU_ARE_DOWN");

medical.providerCopy Anchor Link

Lado: Servidor · Espera: no

medical.provider(): string | null

Devuelve el script de muerte que responde (ai-death...), o null cuando no hay ninguno en marcha.

console.log(`deaths through ${medical.provider() ?? "nothing"}`);

stressCopy Anchor Link

El estrés de los jugadores (de 0 a 100) a través de la capa de estrés de ai-core, sea cual sea el HUD que lo lleve.

stress.gainCopy Anchor Link

Añade puntos de estrés.

Lado: Servidor · Espera: no

stress.gain(source: number, amount: number): boolean

local ok = aiLib.stress.gain(source, amount)

Devuelve true cuando se añadieron, false cuando no hay un HUD con estrés en marcha.

stress.gain(source, 5); // después de un tiroteo

stress.relieveCopy Anchor Link

Quita puntos de estrés.

Lado: Servidor · Espera: no

stress.relieve(source: number, amount: number): boolean

local ok = aiLib.stress.relieve(source, amount)

Devuelve true cuando se quitaron, false cuando no hay un HUD con estrés en marcha o amount es 0 o menos.

inventory.registerUsableItem("cigarette", (source) => {
  stress.relieve(source, 10);
});

stress.providerCopy Anchor Link

Lado: Servidor · Espera: no

stress.provider(): string | null

local name = aiLib.stress.provider()

Devuelve el HUD que lleva el estrés, o null.

if (!stress.provider()) console.log("no HUD keeps stress");

needsCopy Anchor Link

needs.refillCopy Anchor Link

Llena por completo el hambre y la sed (revivir de admin, hospital), a través del HUD que las lleva, o de los metadatos del personaje de ai-core si no hay ninguno.

Lado: Servidor · Espera: no

needs.refill(source: number): boolean

Sin equivalente en Lua: llama al export de ai-core RefillNeeds(source).

Devuelve true cuando se rellenaron, false cuando el jugador no tiene personaje.

if (medical.revive(target)) needs.refill(target);

Definiciones de trabajos y bandasCopy Anchor Link

definitions.jobCopy Anchor Link

La definición de un trabajo tal como está en el panel de ai-core. Cada una se lee una vez de ai-core y se guarda hasta que el panel la cambia, así que una lectura es una consulta en memoria.

Lado: Servidor · Espera: no

definitions.job(name: string): JobDefinition | null

Sin equivalente en Lua: llama al export de ai-core GetJobDefinition(name).

Devuelve JobDefinition (label, type, defaultDuty, listed?, grades), o null cuando no existe ese trabajo.

const label = definitions.job("police")?.label ?? "police";

definitions.gangCopy Anchor Link

Lado: Servidor · Espera: no

definitions.gang(name: string): GangDefinition | null

Sin equivalente en Lua: llama al export de ai-core GetGangDefinition(name).

Devuelve GangDefinition (label, grades), o null.

const gang = definitions.gang("ballas");
if (!gang) return fail("UNKNOWN_GANG");

Horas puntaCopy Anchor Link

isPrimeTimeCopy Anchor Link

Si es hora punta para un trabajo, según el ajuste de horas punta de ai-core. Las horas vienen de tgiann-policealert mientras está en marcha, o si no, de las horas fijadas en el panel de ai-core.

Lado: Servidor · Espera: no

isPrimeTime(job?: string): boolean

Sin equivalente en Lua: llama al export de ai-core IsPrimeTime(job).

Devuelve true durante las horas punta.

if (!isPrimeTime("police")) return fail("BANK_CLOSED_FOR_HEISTS");