Meslekler ve hizmetler
Polis ihbarları, hapis, MDT kayıtları, sağlıkçılar, canlandırma ve iyileştirme, stres, açlık ve susuzluk, meslek ve çete tanımları, prime time.
import { jobs, dispatch, prison, mdt, ems, medical, stress, needs, definitions, isPrimeTime } from "@aicore8/lib/server";jobs ve definitions ai-core'un kendisidir: bir karakterin meslekleri ve çeteleri ile sunucunun meslek tanımları. Buradaki geri kalan her şey ai-core'un katmanlarından biri üzerinden gider; o işi sunucuda hangi script yapıyorsa (bir ihbar sistemi, bir hapishane, bir MDT, bir ölüm script'i, bir HUD) o cevap verir. Sahibi onu değiştirdiğinde script'in çalışmaya devam eder. Böyle bir script çalışmıyorken o çağrılar sessizce başarısız olur (false, 0, null).
jobs
jobs, yüklü bir oyuncunun ai-core üzerinden kendi meslekleri ve çeteleridir: bir karakter birkaç meslek tutabilir, en çok birinde görevdedir ve bir seferde bir çete adına hareket eder. Çok oyuncuyu birden okumak lib'in aynasıdır (online); bağlı olmayan bir karakteri değiştirmek characters ile olur.
jobs.current
Diğer script'lerin bir oyuncunun "mesleği" olarak gördüğü meslek: görevde olduğu meslek, yoksa en son görevde olduğu, yoksa tuttuğu ilk meslek, yoksa işsizlik mesleği.
Taraf: Server · Bekler: hayır
jobs.current(source: number): JobMembership | nulllocal current = aiLib.jobs.current(source)Dönüş değeri
Bir JobMembership ({ job, grade }) ya da oyuncunun yüklü karakteri yoksa null.
Örnek
import { jobs } from "@aicore8/lib/server";
export function isOfficer(source: number): boolean {
return jobs.current(source)?.job === "police";
}jobs.list
Oyuncunun tuttuğu bütün meslekler.
Taraf: Server · Bekler: hayır
jobs.list(source: number): JobMembership[]local list = aiLib.jobs.list(source)Dönüş değeri
Bir JobMembership dizisi. Oyuncunun yüklü karakteri yoksa ya da hiç mesleği yoksa boş.
jobs.duty and jobs.setDuty
Oyuncunun hangi meslekte görevde olduğu ve göreve girip çıkması. Çok script üyelik yerine görev durumunu kontrol eder: görevde olmayan bir polis sivildir.
Taraf: Server · Bekler: hayır
jobs.duty(source: number): string | null
jobs.setDuty(source: number, job: string | null): booleanlocal onDutyIn = aiLib.jobs.duty(source)
local ok = aiLib.jobs.setDuty(source, job)Parametreler
Prop
Type
Dönüş değeri
jobs.duty: meslek adı ya da görevde değilse (veya karakter yoksa) null. jobs.setDuty: değişiklik yapıldıysa true, oyuncunun tutmadığı bir meslek için false.
jobs.set
Oyuncuya bir meslek ekler ya da tuttuğu bir mesleğin derecesini değiştirir. Panelin kuralları geçerlidir: bir karakterin kaç meslek tutabileceği ve ikinci bir mesleğe hiç izin verilip verilmediği.
Taraf: Server · Bekler: hayır
jobs.set(source: number, job: string, grade: number): booleanlocal ok = aiLib.jobs.set(source, job, grade)Parametreler
Prop
Type
Dönüş değeri
boolean: sonrasında oyuncu o mesleği o derecede tutuyorsa true. Yüklü karakter yoksa, meslek bilinmiyorsa, derece yoksa ya da panelin meslek sınırı aşılıyorsa false.
Örnek
import { jobs, notify } from "@aicore8/lib/server";
export function hire(source: number, job: string): void {
if (!jobs.set(source, job, 0)) return notify(source, "İşe alınamadı", "error");
notify(source, `${job} ekibine hoş geldin`, "success");
}jobs.remove
Bir mesleği geri alır. Hiç mesleği kalmayan bir karakter işsiz sayılır: işsizlik mesleğinin kendisi asla kaydedilmez.
Taraf: Server · Bekler: hayır
jobs.remove(source: number, job: string): booleanlocal ok = aiLib.jobs.remove(source, job)Dönüş değeri
boolean: meslek geri alındıysa true, oyuncu onu tutmuyorsa (ya da yüklü karakteri yoksa) false.
jobs.unemployed
Mesleği olmayan bir karakterin sahip olduğu meslek adı, panelde ayarlandığı gibi. Asla "unemployed" varsayma: bir sunucu ona istediği adı verebilir.
Taraf: Server · Bekler: hayır
jobs.unemployed(): stringlocal name = aiLib.jobs.unemployed()Dönüş değeri
string: panelden gelen meslek adı.
jobs.onDutyCount
Şu anda bir meslekte kaç oyuncunun görevde olduğu - bir ihbar sisteminin ya da bir meslek kapısının genelde istediği sayı.
Taraf: Server · Bekler: hayır
jobs.onDutyCount(job: string): numberlocal count = aiLib.jobs.onDutyCount(job)Dönüş değeri
number: o meslekte görevde olan bağlı oyuncu sayısı, kimse yoksa 0.
jobs.gangs
Oyuncunun içinde olduğu bütün çeteler.
Taraf: Server · Bekler: hayır
jobs.gangs(source: number): GangMembership[]local list = aiLib.jobs.gangs(source)Dönüş değeri
Bir GangMembership dizisi; hiçbirinde değilse boş.
jobs.activeGang and jobs.setActiveGang
Bir karakter birkaç çetede olabilir ama bir seferde biri adına hareket eder: o aktif çetedir ve bir bölge ya da uyuşturucu script'inin okuması gereken budur.
Taraf: Server · Bekler: hayır
jobs.activeGang(source: number): string | null
jobs.setActiveGang(source: number, gang: string | null): booleanlocal active = aiLib.jobs.activeGang(source)
local ok = aiLib.jobs.setActiveGang(source, gang)Dönüş değeri
jobs.activeGang: çete adı ya da aktif çete yoksa null. jobs.setActiveGang: değişiklik yapıldıysa true, oyuncunun içinde olmadığı bir çete için false (null aktif çeteyi temizler).
jobs.setGang and jobs.removeGang
Oyuncunun bir çetesini ekler, derecesini değiştirir ya da kaldırır.
Taraf: Server · Bekler: hayır
jobs.setGang(source: number, gang: string, grade: number): boolean
jobs.removeGang(source: number, gang: string): booleanlocal ok = aiLib.jobs.setGang(source, gang, grade)
local ok = aiLib.jobs.removeGang(source, gang)Dönüş değeri
Meslek çağrıları gibi boolean: yüklü karakter yoksa, çete ya da derece bilinmiyorsa false.
dispatch
dispatch.alert
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): booleanlocal ok = aiLib.dispatch.alert(alert)DispatchAlert
Prop
Type
Tipi DispatchAlert’tir.
Dönüş değeri
boolean: gönderildiyse true. Hiçbir ihbar sistemi çalışmıyorsa ya da ihbar geçersizse false.
Örnek
import { dispatch, coordsOf, createLocale } from "@aicore8/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",
});
}prison
Hangi hapishane script’i çalışıyorsa onun üzerinden, ai-core ile hapis cezaları.
prison.jail
Yüklü bir oyuncuyu hapse gönderir.
Taraf: Server · Bekler: hayır
prison.jail(source: number, minutes: number, by?: number): booleanlocal ok = aiLib.prison.jail(source, minutes, by)Prop
Type
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.release
Hapisteki bir oyuncuyu serbest bırakır.
Taraf: Server · Bekler: hayır
prison.release(source: number): booleanlocal 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.timeLeft
Taraf: Server · Bekler: hayır
prison.timeLeft(source: number): numberlocal minutes = aiLib.prison.timeLeft(source)Dönüş değeri: kalan ceza dakikası; özgürse 0.
if (prison.timeLeft(source) > 0) return fail("IN_PRISON");mdt
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.record
Polis MDT’sine bir kayıt yazar.
Taraf: Server · Bekler: hayır
mdt.record(record: MdtRecord): booleanlocal ok = aiLib.mdt.record(record)MdtRecord
Prop
Type
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.provider
Taraf: Server · Bekler: hayır
mdt.provider(): string | nulllocal 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");ems
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.available
Bir çağrıyı almaya müsait kaç sağlıkçı olduğu.
Taraf: Server · Bekler: hayır
ems.available(jobs: string[]): numberlocal count = aiLib.ems.available(jobs)Prop
Type
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.distress
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): booleanlocal ok = aiLib.ems.distress(source, call)Prop
Type
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.provider
Taraf: Server · Bekler: hayır
ems.provider(): string | nulllocal 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()}`);medical
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.revive
Yerdeki bir oyuncuyu yattığı yerde ayağa kaldırır.
Taraf: Server · Bekler: hayır
medical.revive(source: number): booleanDö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.heal
Yerde olmayan bir oyuncuya tam can verir.
Taraf: Server · Bekler: hayır
medical.heal(source: number): booleanDönüş değeri: iyileştirildiyse true, hiçbir ölüm script’i çalışmıyorsa false.
medical.heal(source);medical.isDead
Oyuncunun yerde olup olmadığı.
Taraf: Server · Bekler: hayır
medical.isDead(source: number): booleanDö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.provider
Taraf: Server · Bekler: hayır
medical.provider(): string | nullDö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"}`);stress
Stresi hangi HUD tutuyorsa ai-core’un stres katmanı üzerinden oyuncuların stresi (0 ile 100 arası).
stress.gain
Stres puanı ekler.
Taraf: Server · Bekler: hayır
stress.gain(source: number, amount: number): booleanlocal ok = aiLib.stress.gain(source, amount)Prop
Type
Dönüş değeri: eklendiyse true, stresli bir HUD çalışmıyorsa false.
stress.gain(source, 5); // bir çatışmadan sonrastress.relieve
Stres puanı düşürür.
Taraf: Server · Bekler: hayır
stress.relieve(source: number, amount: number): booleanlocal 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.provider
Taraf: Server · Bekler: hayır
stress.provider(): string | nulllocal name = aiLib.stress.provider()Dönüş değeri: stresi tutan HUD ya da null.
if (!stress.provider()) console.log("no HUD keeps stress");needs
needs.refill
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): booleanLua 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ı
definitions.job
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 | nulllocal definition = aiLib.definitions.job(name)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.gang
Taraf: Server · Bekler: hayır
definitions.gang(name: string): GangDefinition | nulllocal definition = aiLib.definitions.gang(name)Dönüş değeri: GangDefinition (label, grades) ya da null.
const gang = definitions.gang("ballas");
if (!gang) return fail("UNKNOWN_GANG");definitions.registerJob and definitions.removeJob
Sahibinin panele eklemesine gerek kalmadan script'inin getirdiği bir meslek: çağıran resource'a ait olur, resource durduğunda gider ve panelin dosyasına asla yazılmaz.
Taraf: Server · Bekler: hayır
definitions.registerJob(name: string, definition: JobDefinition): CharacterResult
definitions.removeJob(name: string): booleanlocal result = aiLib.definitions.registerJob(name, definition)
local ok = aiLib.definitions.removeJob(name)Parametreler
Prop
Type
Dönüş değeri
registerJob ActionResult döner: { ok: true } ya da panelde o adda bir meslek varsa / başka bir resource onu kaydettiyse bir dil anahtarıyla { ok: false, error } - sunucu sahibinin paneli her zaman kazanır. removeJob yalnızca bu resource'un kaydettiği bir meslek için true döner.
Örnek
import { definitions } from "@aicore8/lib/server";
// Başlangıçta bir kez: meslek bu resource çalıştığı sürece var olur.
const result = definitions.registerJob("garbage", {
label: "Garbage",
type: "job",
defaultDuty: true,
grades: [{ label: "Driver", salary: 60, boss: false }],
});
if (!result.ok) console.log(`meslek kaydedilmedi: ${result.error}`);Sunucu sahibinin düzenleyebilmesi gereken bir meslek buraya değil panele aittir. Meslek script'inin bir parçasıysa ve onsuz bir anlamı yoksa burada kaydet.
definitions.registerGang and definitions.removeGang
Çeteler için aynısı.
Taraf: Server · Bekler: hayır
definitions.registerGang(name: string, definition: GangDefinition): CharacterResult
definitions.removeGang(name: string): booleanlocal result = aiLib.definitions.registerGang(name, definition)
local ok = aiLib.definitions.removeGang(name)Dönüş değeri
Mesleklerde olduğu gibi: kayıt için ActionResult, kaldırma için boolean.
Prime time
isPrimeTime
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): booleanLua karşılığı yok: ai-core’un IsPrimeTime(job) export’unu çağır.
Prop
Type
Dönüş değeri: prime time sırasında true.
if (!isPrimeTime("police")) return fail("BANK_CLOSED_FOR_HEISTS");Para ve bankacılık
İki hesap arasında money.transfer, ai-core üzerinden banka script’i ve hangi fatura script’i çalışıyorsa onun üzerinden faturalar.
Dünya
Hangi hava script’i çalışıyorsa onun üzerinden saat ve hava, ai-core’un dağıtıcısından routing bucket’lar, kapı kilitleri ve kayıtlı karakterlerin doğma noktaları.