Meslekler ve hizmetler

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

Buradaki her nesne ai-core’un katmanlarından biri üzerinden gider: sunucunun o iş için çalıştırdığı script (bir ihbar sistemi, bir hapishane, bir MDT, bir ölüm script’i, bir HUD) cevap verir. Sahip onu değiştirdiğinde script’in çalışmaya devam eder. Böyle bir script çalışmıyorken çağrılar sessizce başarısız olur (false, 0, null).

dispatchCopy Anchor Link

dispatch.alertCopy Anchor Link

Bir polis (ya da başka bir meslek) ihbarı gönderir. İhbar sistemi onu jobs’un görevdeki üyelerine gösterir; varsayılan polis meslekleridir.

Taraf: Server · Bekler: hayır

dispatch.alert(alert: DispatchAlert): boolean

local ok = aiLib.dispatch.alert(alert)

DispatchAlertCopy Anchor Link

Tipi DispatchAlert’tir.

Dönüş değeriCopy Anchor Link

boolean: gönderildiyse true. Hiçbir ihbar sistemi çalışmıyorsa ya da ihbar geçersizse false.

ÖrnekCopy 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

Hangi hapishane script’i çalışıyorsa onun üzerinden, ai-core ile hapis cezaları.

prison.jailCopy Anchor Link

Yüklü bir oyuncuyu hapse gönderir.

Taraf: Server · Bekler: hayır

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

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

Dönüş değeri: hapse gönderildiyse true, hiçbir hapishane çalışmıyorken false.

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

prison.releaseCopy Anchor Link

Hapisteki bir oyuncuyu serbest bırakır.

Taraf: Server · Bekler: hayır

prison.release(source: number): boolean

local ok = aiLib.prison.release(source)

Dönüş değeri: serbest bırakıldıysa true; hapiste değilse ya da hiçbir hapishane çalışmıyorsa false.

prison.release(target);

prison.timeLeftCopy Anchor Link

Taraf: Server · Bekler: hayır

prison.timeLeft(source: number): number

local minutes = aiLib.prison.timeLeft(source)

Dönüş değeri: kalan ceza dakikası; özgürse 0.

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

mdtCopy Anchor Link

ai-core’un MDT katmanı üzerinden polis MDT kayıtları (cezalar, aranma kararları, tutuklamalar, hapis). Hiçbir MDT çalışmıyorken hiçbir şey yazılmaz.

mdt.recordCopy Anchor Link

Polis MDT’sine bir kayıt yazar.

Taraf: Server · Bekler: hayır

mdt.record(record: MdtRecord): boolean

local ok = aiLib.mdt.record(record)

MdtRecordCopy Anchor Link

Tipi MdtRecord’dur.

Dönüş değeri: yazıldıysa true; hiçbir MDT çalışmıyorsa ya da MDT böyle bir kayıt almıyorsa false.

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

mdt.providerCopy Anchor Link

Taraf: Server · Bekler: hayır

mdt.provider(): string | null

local name = aiLib.mdt.provider()

Dönüş değeri: kayıtların gittiği MDT ya da null.

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

emsCopy Anchor Link

ai-core’un EMS katmanı üzerinden sağlıkçılar: bir EMS script’inin kendi sayımı ve yardım çağrıları, yoksa ai-core’un görev sayımları ve ihbarları.

ems.availableCopy Anchor Link

Bir çağrıyı almaya müsait kaç sağlıkçı olduğu.

Taraf: Server · Bekler: hayır

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

local count = aiLib.ems.available(jobs)

Dönüş değeri: jobs içinde görevdeki sağlıkçı sayısı; bir dispatch script’i meşgul olanları biliyorsa onlar dışarıda bırakılır.

// Oyuncuların hastanede yeniden doğmasına yalnızca hiçbir sağlıkçı gelemiyorsa izin ver.
const canRespawn = ems.available(["ambulance"]) === 0;

ems.distressCopy Anchor Link

Bir oyuncu için call.jobs sağlıkçılarına bir yardım çağrısı gönderir.

Taraf: Server · Bekler: hayır

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

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

Tipi DistressCall’dur.

Dönüş değeri: bir şey çağrıyı aldıysa true, değilse false.

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

ems.providerCopy Anchor Link

Taraf: Server · Bekler: hayır

ems.provider(): string | null

local name = aiLib.ems.provider()

Dönüş değeri: katmanın kullandığı EMS kaynağı; kendi görev sayımları için "ai-core".

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

medicalCopy Anchor Link

Hangi ölüm ya da ambulans script’i çalışıyorsa ai-core’un medical katmanı üzerinden canlandırma, iyileştirme ve yerde olma durumu. Lua karşılığı yok: ai-core’un RevivePlayer, HealPlayer, IsPlayerDead export’larını çağır.

medical.reviveCopy Anchor Link

Yerdeki bir oyuncuyu yattığı yerde ayağa kaldırır.

Taraf: Server · Bekler: hayır

medical.revive(source: number): boolean

Dönüş değeri: canlandırıldıysa true; yerde değilse ya da hiçbir ölüm script’i çalışmıyorsa false.

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

medical.healCopy Anchor Link

Yerde olmayan bir oyuncuya tam can verir.

Taraf: Server · Bekler: hayır

medical.heal(source: number): boolean

Dönüş değeri: iyileştirildiyse true, hiçbir ölüm script’i çalışmıyorsa false.

medical.heal(source);

medical.isDeadCopy Anchor Link

Oyuncunun yerde olup olmadığı.

Taraf: Server · Bekler: hayır

medical.isDead(source: number): boolean

Dönüş değeri: yerdeyse true; ölüm script’i yoksa false. Ped’in canını okumak yerine bunu kullan.

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

medical.providerCopy Anchor Link

Taraf: Server · Bekler: hayır

medical.provider(): string | null

Dönüş değeri: cevap veren ölüm script’i (ai-death...) ya da hiçbiri çalışmıyorsa null.

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

stressCopy Anchor Link

Stresi hangi HUD tutuyorsa ai-core’un stres katmanı üzerinden oyuncuların stresi (0 ile 100 arası).

stress.gainCopy Anchor Link

Stres puanı ekler.

Taraf: Server · Bekler: hayır

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

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

Dönüş değeri: eklendiyse true, stresli bir HUD çalışmıyorsa false.

stress.gain(source, 5); // bir çatışmadan sonra

stress.relieveCopy Anchor Link

Stres puanı düşürür.

Taraf: Server · Bekler: hayır

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

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

Dönüş değeri: düşürüldüyse true; stresli bir HUD çalışmıyorsa ya da amount 0 veya daha azsa false.

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

stress.providerCopy Anchor Link

Taraf: Server · Bekler: hayır

stress.provider(): string | null

local name = aiLib.stress.provider()

Dönüş değeri: stresi tutan HUD ya da null.

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

needsCopy Anchor Link

needs.refillCopy Anchor Link

Açlığı ve susuzluğu, onları tutan HUD üzerinden ya da HUD yoksa ai-core’un karakter metadata’sı üzerinden tamamen doldurur (admin canlandırması, hastane).

Taraf: Server · Bekler: hayır

needs.refill(source: number): boolean

Lua karşılığı yok: ai-core’un RefillNeeds(source) export’unu çağır.

Dönüş değeri: doldurulduysa true, oyuncunun karakteri yoksa false.

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

Meslek ve çete tanımlarıCopy Anchor Link

definitions.jobCopy Anchor Link

ai-core’un panelinde ayarlandığı haliyle bir mesleğin tanımı. Her biri ai-core’dan bir kez okunur ve panel onu değiştirene kadar tutulur; bu yüzden bir okuma bellekten bakmaktır.

Taraf: Server · Bekler: hayır

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

Lua karşılığı yok: ai-core’un GetJobDefinition(name) export’unu çağır.

Dönüş değeri: JobDefinition (label, type, defaultDuty, listed?, grades) ya da böyle bir meslek yoksa null.

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

definitions.gangCopy Anchor Link

Taraf: Server · Bekler: hayır

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

Lua karşılığı yok: ai-core’un GetGangDefinition(name) export’unu çağır.

Dönüş değeri: GangDefinition (label, grades) ya da null.

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

Prime timeCopy Anchor Link

isPrimeTimeCopy Anchor Link

ai-core’un prime time ayarına göre bir meslek için prime time olup olmadığı. Saatler tgiann-policealert çalışıyorken ondan, yoksa ai-core’un panelinde ayarlanan saatlerden gelir.

Taraf: Server · Bekler: hayır

isPrimeTime(job?: string): boolean

Lua karşılığı yok: ai-core’un IsPrimeTime(job) export’unu çağır.

Dönüş değeri: prime time sırasında true.

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