Работы и службы

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

Каждый объект здесь работает через один из слоёв ai-core: отвечает тот скрипт, который сервер использует для этой задачи (система оповещений, тюрьма, MDT, скрипт смерти, HUD). Ваш скрипт продолжает работать, когда владелец его меняет. Пока такой скрипт не запущен, вызовы тихо завершаются неудачей (false, 0, null).

dispatchCopy Anchor Link

dispatch.alertCopy Anchor Link

Отправляет оповещение полиции (или другой работе). Система оповещений показывает его членам jobs на дежурстве, по умолчанию полицейским работам.

Сторона: Сервер · Ждёт: нет

dispatch.alert(alert: DispatchAlert): boolean

local ok = aiLib.dispatch.alert(alert)

DispatchAlertCopy Anchor Link

Тип: DispatchAlert.

ВозвращаетCopy Anchor Link

boolean: true, если отправлено. false, если не запущена система оповещений или оповещение неверное.

ПримерCopy 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

Тюремные сроки через ai-core, какой бы скрипт тюрьмы ни был запущен.

prison.jailCopy Anchor Link

Отправляет загруженного игрока в тюрьму.

Сторона: Сервер · Ждёт: нет

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

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

Возвращает true, если посажен, false, пока не запущена тюрьма.

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

prison.releaseCopy Anchor Link

Выпускает заключённого игрока.

Сторона: Сервер · Ждёт: нет

prison.release(source: number): boolean

local ok = aiLib.prison.release(source)

Возвращает true, если освобождён, false, если игрок не в тюрьме или тюрьма не запущена.

prison.release(target);

prison.timeLeftCopy Anchor Link

Сторона: Сервер · Ждёт: нет

prison.timeLeft(source: number): number

local minutes = aiLib.prison.timeLeft(source)

Возвращает оставшиеся минуты срока, 0, если игрок на свободе.

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

mdtCopy Anchor Link

Полицейские записи MDT (штрафы, ордера, аресты, тюрьма) через слой MDT ai-core. Пока MDT не запущен, ничего не записывается.

mdt.recordCopy Anchor Link

Записывает запись в полицейский MDT.

Сторона: Сервер · Ждёт: нет

mdt.record(record: MdtRecord): boolean

local ok = aiLib.mdt.record(record)

MdtRecordCopy Anchor Link

Тип: MdtRecord.

Возвращает true, если записано, false, если MDT не запущен или не принимает такую запись.

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

mdt.providerCopy Anchor Link

Сторона: Сервер · Ждёт: нет

mdt.provider(): string | null

local name = aiLib.mdt.provider()

Возвращает MDT, в который уходят записи, или null.

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

emsCopy Anchor Link

Медики через слой EMS ai-core: собственный подсчёт и вызовы бедствия скрипта EMS, иначе подсчёт дежурных и оповещения ai-core.

ems.availableCopy Anchor Link

Сколько медиков свободно, чтобы принять вызов.

Сторона: Сервер · Ждёт: нет

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

local count = aiLib.ems.available(jobs)

Возвращает число медиков на дежурстве в jobs, не считая занятых, если скрипт диспетчера о них знает.

// Разрешаем игрокам возрождаться в больнице, только если ни один медик не может приехать.
const canRespawn = ems.available(["ambulance"]) === 0;

ems.distressCopy Anchor Link

Отправляет вызов бедствия для игрока медикам из call.jobs.

Сторона: Сервер · Ждёт: нет

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

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

Тип: DistressCall.

Возвращает true, если вызов кто-то принял, иначе false.

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

ems.providerCopy Anchor Link

Сторона: Сервер · Ждёт: нет

ems.provider(): string | null

local name = aiLib.ems.provider()

Возвращает источник EMS, который использует слой, "ai-core" для собственного подсчёта дежурных.

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

medicalCopy Anchor Link

Реанимация, лечение и состояние без сознания через медицинский слой ai-core, какой бы скрипт смерти или скорой помощи ни был запущен. Lua-аналога нет: вызывайте экспорты ai-core RevivePlayer, HealPlayer, IsPlayerDead.

medical.reviveCopy Anchor Link

Поднимает игрока без сознания там, где он лежит.

Сторона: Сервер · Ждёт: нет

medical.revive(source: number): boolean

Возвращает true, если реанимирован, false, если игрок не без сознания или не запущен скрипт смерти.

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

medical.healCopy Anchor Link

Полностью восстанавливает здоровье игроку, который не лежит без сознания.

Сторона: Сервер · Ждёт: нет

medical.heal(source: number): boolean

Возвращает true, если вылечен, false, если не запущен скрипт смерти.

medical.heal(source);

medical.isDeadCopy Anchor Link

Лежит ли игрок без сознания.

Сторона: Сервер · Ждёт: нет

medical.isDead(source: number): boolean

Возвращает true, если без сознания; false без скрипта смерти. Используйте вместо чтения здоровья педа.

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

medical.providerCopy Anchor Link

Сторона: Сервер · Ждёт: нет

medical.provider(): string | null

Возвращает скрипт смерти, который отвечает (ai-death...), или null, если никакой не запущен.

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

stressCopy Anchor Link

Стресс игроков (от 0 до 100) через слой стресса ai-core, какой бы HUD его ни хранил.

stress.gainCopy Anchor Link

Добавляет очки стресса.

Сторона: Сервер · Ждёт: нет

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

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

Возвращает true, если добавлено, false, если не запущен HUD со стрессом.

stress.gain(source, 5); // после перестрелки

stress.relieveCopy Anchor Link

Убирает очки стресса.

Сторона: Сервер · Ждёт: нет

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

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

Возвращает true, если убрано, false, если не запущен HUD со стрессом или amount равен 0 или меньше.

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

stress.providerCopy Anchor Link

Сторона: Сервер · Ждёт: нет

stress.provider(): string | null

local name = aiLib.stress.provider()

Возвращает HUD, который хранит стресс, или null.

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

needsCopy Anchor Link

needs.refillCopy Anchor Link

Полностью восполняет голод и жажду (реанимация администратором, больница) через HUD, который их хранит, а без него через метаданные персонажа ai-core.

Сторона: Сервер · Ждёт: нет

needs.refill(source: number): boolean

Lua-аналога нет: вызывайте экспорт ai-core RefillNeeds(source).

Возвращает true, если восполнено, false, если у игрока нет персонажа.

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

Определения работ и бандCopy Anchor Link

definitions.jobCopy Anchor Link

Определение работы так, как оно задано в панели ai-core. Каждое читается из ai-core один раз и хранится, пока панель его не изменит, поэтому чтение сводится к поиску в памяти.

Сторона: Сервер · Ждёт: нет

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

Lua-аналога нет: вызывайте экспорт ai-core GetJobDefinition(name).

Возвращает JobDefinition (label, type, defaultDuty, listed?, grades) или null, если такой работы нет.

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

definitions.gangCopy Anchor Link

Сторона: Сервер · Ждёт: нет

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

Lua-аналога нет: вызывайте экспорт ai-core GetGangDefinition(name).

Возвращает GangDefinition (label, grades) или null.

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

Прайм-таймCopy Anchor Link

isPrimeTimeCopy Anchor Link

Идёт ли прайм-тайм для работы, по настройке прайм-тайма ai-core. Часы берутся из tgiann-policealert, пока он запущен, иначе из часов, заданных в панели ai-core.

Сторона: Сервер · Ждёт: нет

isPrimeTime(job?: string): boolean

Lua-аналога нет: вызывайте экспорт ai-core IsPrimeTime(job).

Возвращает true во время прайм-тайма.

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