Üyelik ve oyuncu verisi

ai-core yerel oyuncunun kendi verisini onun client’ına gönderir: karakter yüklendiğinde bir snapshot, sonra yalnızca değişen değerler. Bu yardımcılar o kopyayı okur; bu yüzden bir kontrol bir bellek okumasına mal olur ve asla server’a sormaz.

Onları oyuncunun gördükleri için kullan (bir noktanın canShow’u, bir radyal öğesi, bir menü satırı). Oyuncunun aynı veriyle ne yapabileceğine server karar verir (Oyuncular ve karakterler sayfasındaki online): bir client kontrolü asla kanıt değildir.

Oyuncu verisiCopy Anchor Link

ai-core’un tuttuğu değerler, anahtara göre (AiPlayerData):

Üye tipleri CharacterInfo, JobMembership ve GangMembership’dir.

getPlayerDataCopy Anchor Link

Tek bir anahtarın son değeri. Resource’undaki ilk kullanımda ai-core’un zaten gönderdiği her şeyi de okur (ai-core’un GetPlayerData export’undan); böylece oyuncu yüklendikten sonra yeniden başlatılan bir resource değerlere hemen sahip olur.

Taraf: Client · Bekler: hayır

getPlayerData<K extends keyof AiPlayerData>(key: K): AiPlayerData[K] | undefined

local value = aiLib.playerData.get(key)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

AiPlayerData[K] | undefined: değer ya da henüz hiçbir şey gelmediyse (yüklü karakter yok, ai-core başlamadı) undefined (Lua’da nil).

ÖrnekCopy Anchor Link

import { getPlayerData, notify } from "@aicore-fivem/lib/client";

RegisterCommand(
  "whoami",
  () => {
    const character = getPlayerData("character");
    const job = getPlayerData("job");
    const cash = getPlayerData("money")?.cash ?? 0;
    if (!character) return notify("No character loaded", "error");
    notify(`${job?.job ?? "unemployed"} (${job?.grade ?? 0}), $${cash}`, "info");
  },
  false,
);

onPlayerDataCopy Anchor Link

ai-core bu oyuncu için bir anahtar gönderdiğinde her seferinde bir handler çalıştırır.

Taraf: Client · Bekler: hayır

onPlayerData<K extends keyof AiPlayerData>(key: K, handler: (value: AiPlayerData[K]) => void): () => void

aiLib.playerData.onChange(key, function(value) end)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

TypeScript: () => void, handler’ı kaldıran bir fonksiyon. Lua hiçbir şey döndürmez.

ÖrnekCopy Anchor Link

import { onPlayerData } from "@aicore-fivem/lib/client";

const stop = onPlayerData("money", (money) => {
  SendNUIMessage({ action: "money", data: { cash: money.cash ?? 0, bank: money.bank ?? 0 } });
});
// HUD tamamen kapandığında stop()

seedPlayerDataCopy Anchor Link

Değerleri elle doldurur. Zaten değeri olan anahtarlar korunur. Buna ihtiyacın yok: lib ilk kullanımda kendini ai-core’dan doldurur.

Taraf: Client · Bekler: hayır

seedPlayerData(data: Partial<AiPlayerData>): void

Lua karşılığı yok.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

import { seedPlayerData } from "@aicore-fivem/lib/client";

// ai-core olmayan bir test düzeneği.
seedPlayerData({ jobs: [{ job: "police", grade: 3 }], duty: "police" });

Üyelik kontrolleriCopy Anchor Link

hasJobCopy Anchor Link

Görevde olsun ya da olmasın oyuncunun mesleklerden birini minimum bir rütbede tutup tutmadığı.

Taraf: Client · Bekler: hayır

hasJob(jobs: readonly string[], minGrade?: number): boolean

Lua karşılığı yok: aiLib.playerData.get('jobs')’u dolaş (bkz. points.add Lua örneği).

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: liste boşsa ya da oyuncu jobs’tan birini minGrade veya üstünde tutuyorsa true.

ÖrnekCopy Anchor Link

import { hasJob, onMembershipChange, Points } from "@aicore-fivem/lib/client";

const points = new Points();
points.add("armory", {
  coords: { x: 482.6, y: -995.2, z: 30.7 },
  label: "Armory",
  canShow: () => hasJob(["police", "sheriff"], 1),
  onPressed: () => emitNet("mypolice:armory"),
});
onMembershipChange(() => points.refresh());

inGangCopy Anchor Link

Oyuncunun çetelerden birinde minimum bir rütbede olup olmadığı.

Taraf: Client · Bekler: hayır

inGang(gangs: readonly string[], minGrade?: number): boolean

Lua karşılığı yok: aiLib.playerData.get('gangs')’i dolaş.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: liste boşsa ya da oyuncu gangs’ten birinde minGrade veya üstündeyse true.

ÖrnekCopy Anchor Link

import { inGang, radial } from "@aicore-fivem/lib/client";

radial.add({
  id: "mygang:stash",
  label: "Gang stash",
  icon: "box",
  canShow: () => inGang(["ballas", "vagos"], 2),
  onPressed: () => emitNet("mygang:stash"),
});

onDutyInCopy Anchor Link

Oyuncunun mesleklerden birinde görevde olup olmadığı.

Taraf: Client · Bekler: hayır

onDutyIn(jobs: readonly string[]): boolean

Lua karşılığı yok: aiLib.playerData.get('duty') görevdeki meslektir.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: oyuncunun görevdeki mesleği jobs içindeyse true.

ÖrnekCopy Anchor Link

import { onDutyIn, Points } from "@aicore-fivem/lib/client";

const points = new Points();
points.addVehicle("mymech:repair", {
  label: "Repair",
  icon: "wrench",
  canShow: () => onDutyIn(["mechanic"]),
  onPressed: (vehicle) => emitNet("mymech:repair", NetworkGetNetworkIdFromEntity(vehicle)),
});

onMembershipChangeCopy Anchor Link

Oyuncunun meslekleri, görev durumu ya da çeteleri değiştiğinde bir fonksiyon çalıştırır. canShow’u bunları okuyan noktaları ve blip’leri yenilemek için kullan.

Taraf: Client · Bekler: hayır

onMembershipChange(fn: () => void): void

Lua karşılığı yok: jobs, duty ve gangs için aiLib.playerData.onChange.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

import { onMembershipChange, Points, radial } from "@aicore-fivem/lib/client";

const points = new Points();
onMembershipChange(() => {
  points.refresh();
  radial.refresh();
});

allowsCopy Anchor Link

Yerel oyuncunun bir erişim kuralı olan bir yeri kullanıp kullanamayacağı. Server’ın online.allows(source, rule)’u aynı kuralla karar verir; böylece oyuncunun gördüğü, server’ın kullanmasına izin verdiğiyle tam olarak aynıdır. Kuralı bir panel kaydından readAccess(record) (@aicore-fivem/lib/shared) ile oku.

Taraf: Client · Bekler: hayır

allows(rule: AccessRule): boolean

Lua karşılığı yok.

ParametrelerCopy Anchor Link

AccessRuleCopy Anchor Link

Tipi AccessRule’dır.

Dönüş değeriCopy Anchor Link

boolean: iki liste de boşsa (herkes); oyuncu gangs’ten birinde minimum rütbesindeyse; ya da oyuncu jobs’tan birini minimum rütbesinde tutuyorsa (ve onDuty ise o meslekte görevdeyse) true. Aksi halde false.

ÖrnekCopy Anchor Link

import { AdminWorld, allows, callAction, onMembershipChange, Points } from "@aicore-fivem/lib/client";
import { readAccess, readVec3, RecordObjects, type AccessRule } from "@aicore-fivem/lib/shared";

const world = new AdminWorld(["stashes"]);
const points = new Points();

interface Stash { coords: { x: number; y: number; z: number }; access: AccessRule }
const readStash = (_key: string, raw: Record<string, unknown>): Stash | null => {
  const coords = readVec3(raw.coords);
  return coords ? { coords, access: readAccess(raw) } : null;
};

new RecordObjects(world, "stashes", readStash, (id, stash) => {
  points.add(id, {
    coords: stash.coords,
    label: "Stash",
    canShow: () => allows(stash.access),
    onPressed: () => callAction("mystash:open", [id], { fallback: "STASH_FAILED" }),
  });
  return () => points.remove(id);
});

onMembershipChange(() => points.refresh());