Oyuncu

Bu export’lar ai-core’un bu oyunun başındaki oyuncu hakkında bildiklerini okur: karakteri, parası, meslekleri ve çeteleri. Server bu veriyi karakter yüklendiğinde oyuncunun kendi client’ına bir kez gönderir, sonra yalnızca değişen değerleri. Başka hiçbir oyuncunun verisi asla bu client’a ulaşmaz.

GetPlayerDataCopy Anchor Link

ai-core’un yerel oyuncunun yüklü karakteri hakkında bildiği her şeyi tek tabloda döndürür: karakter, para, meslekler, mesai, ana meslek, çeteler, aktif çete ve metadata. Resource’un başladığında veriyi bir kez okumak için kullan; değişiklikleri onPlayerData (TS) ya da aiLib.playerData.onChange (Lua) ile izle.

Taraf: Client · Bekler: hayır

GetPlayerData(): AiPlayerData | null

local data = exports['ai-core']:GetPlayerData() -- tablo ya da nil

ParametrelerCopy Anchor Link

Yok.

Dönüş değeriCopy Anchor Link

Bir karakter dünyada dururken AiPlayerData; karakter ekranında, ilk karakter yüklenmeden önce ve oyuncu karakter ekranına döndükten sonra null (Lua’da nil).

ÖrnekCopy Anchor Link

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

// Oyuncu polis olarak mesaideyken yalnızca polise özel bir blip gösterir.
let blip = 0;

function updateBlip(duty: string | null): void {
  if (duty === "police" && blip === 0) {
    blip = AddBlipForCoord(441.8, -982.0, 30.7); // Mission Row polis karakolu
    SetBlipSprite(blip, 60);
  } else if (duty !== "police" && blip !== 0) {
    RemoveBlip(blip);
    blip = 0;
  }
}

// Bir kez oku (lib senin için ai-core’un GetPlayerData’sına sorar), sonra her değişikliği izle.
updateBlip(getPlayerData("duty") ?? null);
onPlayerData("duty", (duty) => updateBlip(duty));

IsPlayerLoadedCopy Anchor Link

Bu client’ta dünyada bir karakterin durup durmadığını söyler. Resource’un oyuncu zaten yüklendikten sonra başlayabilecekken, karakter gerektiren herhangi bir şeyi (bir HUD, bir meslek döngüsü) başlatmadan önce kullan.

Taraf: Client · Bekler: hayır

IsPlayerLoaded(): boolean

local loaded = exports['ai-core']:IsPlayerLoaded() -- boolean

ParametrelerCopy Anchor Link

Yok.

Dönüş değeriCopy Anchor Link

boolean: karakter dünyaya konduktan sonra true; karakter ekranında, oyuncu bir doğma noktası seçerken ve karakter ekranına döndükten sonra false.

ÖrnekCopy Anchor Link

import { resourceExport } from "@aicore-fivem/lib/client";
import { CORE } from "@aicore-fivem/shared";

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

function start(): void {
  console.log("character ready, starting the job loop");
}

// Oyuncu bu resource başlamadan önce yüklenmiş olabilir (bir restart): önce kontrol et, sonra dinle.
if (core.IsPlayerLoaded()) start();
on(CORE.clientPlayerLoadedEvent, start);

GetDefinitionsCopy Anchor Link

Admin panelinin sakladığı haliyle her mesleği ya da her çeteyi döndürür (etiketler, rütbeler ve panelin düzenlediği diğer alanlar). Framework köprüleri ESX / QB meslek tablolarını kurmak için bunu kullanır. Bir kez oku, sonra panelin değiştirdiği her meslek ya da çete için tetiklenen ai-core:client:definitions client event’ini izle.

Taraf: Client · Bekler: hayır

GetDefinitions(file: "jobs" | "gangs"): Record<string, unknown> | null

local jobs = exports['ai-core']:GetDefinitions('jobs') -- meslek adına göre anahtarlanmış tablo ya da nil

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Record<string, unknown>: adına göre anahtarlanmış (police, ambulance) meslek ya da çete başına bir kayıt. Kayıtlar panelin kendi verisidir ve kontrol edilmez. file ne "jobs" ne "gangs" ise null.

ÖrnekCopy Anchor Link

import { resourceExport } from "@aicore-fivem/lib/client";
import { CORE } from "@aicore-fivem/shared";

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

// Her mesleğin güncel tutulan yerel bir kopyası.
const jobs: Record<string, unknown> = { ...(core.GetDefinitions("jobs") ?? {}) };

on(CORE.clientDefinitionsEvent, (file: string, name: string, definition: unknown) => {
  if (file !== "jobs") return;
  if (definition === null) delete jobs[name];
  else jobs[name] = definition;
});