EMS

The EMS layer answers two questions for any script: "how many medics can take a call?" and "send the medics a distress call". ai-core asks the EMS source the panel's EMS source setting picks, or the first EMS script running. What that script cannot answer, ai-core answers itself: free medics from its own on-duty counts, and a distress call as a high-priority alert to the jobs through the dispatch layer.

GetEmsSystemCopy Anchor Link

The EMS source in use.

Side: Server · Waits: no · Lib: ems.provider()

GetEmsSystem(): string | null

local system = exports['ai-core']:GetEmsSystem() -- 'ai-core' or a script name

ParametersCopy Anchor Link

None.

ReturnsCopy Anchor Link

string | null: the EMS script's resource name, or "ai-core" when ai-core's own part answers (no EMS script runs). ai-core's own part is always there, so in practice this is never null.

ExampleCopy Anchor Link

import { addCommand, resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");

addCommand("emssystem", { help: "Shows the EMS source", restricted: true }, () => {
  console.log(core.GetEmsSystem());
});

GetAvailableMedicsCopy Anchor Link

How many medics in the given jobs can take a call now. An EMS script with a dispatch of its own leaves busy medics out; ai-core's own answer is everyone on duty.

Side: Server · Waits: no · Lib: ems.available

GetAvailableMedics(jobs: string[]): number

local medics = exports['ai-core']:GetAvailableMedics({ 'ambulance' })

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

number: free medics. 0 for none, an empty list or a value that is not a list. When the EMS script fails, ai-core's own on-duty count answers.

ExampleCopy Anchor Link

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

const core = resourceExport("ai-core");
const EMS_JOBS = ["ambulance"];

// The "respawn at hospital" button only works while no medic can come.
onClientCallback("myscript:respawn", (source) => {
  if (!core.IsPlayerDead(source)) return fail("NOT_DOWN");
  if (core.GetAvailableMedics(EMS_JOBS) > 0) return fail("MEDICS_AVAILABLE");
  // ... move the player to the hospital and revive
  return { ok: true };
});

SendDistressCopy Anchor Link

Sends a downed player's distress call to the medics. With an EMS script that takes calls, the call goes there; otherwise ai-core sends a high-priority alert (code 10-52, a medical kit icon, the player's position) to the on-duty members of jobs through the active alert system.

Side: Server · Waits: no · Lib: ems.distress

SendDistress(source: number, call: DistressCall): boolean

local sent = exports['ai-core']:SendDistress(source, { jobs = { 'ambulance' }, message = 'Unconscious' })

ParametersCopy Anchor Link

DistressCallCopy Anchor Link

See DistressCall.

ReturnsCopy Anchor Link

boolean: true when something took the call. false when the player is not online, jobs is empty, the EMS script refused it, or ai-core's own alert found no alert system running.

ExampleCopy Anchor Link

import { onClientCallback, Cooldowns, resourceExport } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";
import { Locale } from "common";

const core = resourceExport("ai-core");
const cooldowns = new Cooldowns();

// The "call a medic" button on the death screen, once per minute.
onClientCallback("myscript:distress", (source) => {
  if (!core.IsPlayerDead(source)) return fail("NOT_DOWN");
  if (!cooldowns.take(source, 60_000)) return fail("WAIT");
  const sent = core.SendDistress(source, { jobs: ["ambulance"], message: Locale("DISTRESS_UNCONSCIOUS") });
  return sent ? { ok: true } : fail("NO_MEDICS");
});