Client event’leri

ai-core’un client’ı bu event’leri oyuncunun kendi oyununda TriggerEvent ile tetikler. O oyuncunun her client resource’u onları duyar; diğer oyuncular asla duymaz. Yalnızca yerel oyuncuyu anlatırlar.

ai-core:client:playerLoadedCopy Anchor Link

Yerel oyuncunun karakteri dünyada duruyor. Karakter başına client işini burada başlat (HUD değerleri, meslek blip’leri, döngüler).

Taraf: Client · Sabit: CORE.clientPlayerLoadedEvent

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

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

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

function start(data: AiPlayerData): void {
  console.log(`hello ${data.character?.firstname}, cash ${data.money.cash ?? 0}`);
}

// Oyuncu zaten dünyadayken bir resource restart’ını da kapsar.
const now = core.GetPlayerData();
if (now) start(now);
on(CORE.clientPlayerLoadedEvent, start);

ai-core:client:playerUnloadedCopy Anchor Link

Yerel karakter bırakıldı: oyuncu karakter ekranına döndü. Karakter başına işi durdur ve o karakter için tuttuklarını temizle. (Oyuncu sunucudan ayrıldığında oyunu kapanır; hiçbir şey tetiklenmez.)

Taraf: Client · Sabit: CORE.clientPlayerUnloadedEvent

ArgümanlarCopy Anchor Link

Yok.

DinleyiciCopy Anchor Link

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

on(CORE.clientPlayerUnloadedEvent, () => {
  SendNUIMessage({ action: "reset" });
});

ai-core:client:deadCopy Anchor Link

Hangi ölüm script’i çalışıyorsa onda yerel oyuncu yere düştü (ölü ya da last stand) veya ayağa kalktı. Yalnızca bir değişiklikte tetiklenir.

Taraf: Client · Sabit: CORE.clientDeadEvent · Lib: medical.onChange

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

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

// on(CORE.clientDeadEvent, ...) ile aynı.
medical.onChange((dead) => {
  if (dead) SendNUIMessage({ action: "close" });
});

ai-core:client:cacheCopy Anchor Link

Yerel oyuncunun önbellekteki bir değeri değişti. ai-core’daki tek bir izleyici her resource için ped’i, aracı, koltuğu ve silahı okur ve bunu yalnızca bir değer değiştiğinde tetikler, böylece hiçbir resource onları yoklamak zorunda kalmaz. Lib’in cache ve onCache’i (Lua’da aiLib.cache ve aiLib.cache.onChange) bunun üstüne kurulmuştur; onları kullan.

Taraf: Client · Sabit: CORE.clientCacheEvent

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

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

onCache("vehicle", (vehicle, old) => {
  if (vehicle !== false) console.log(`entered vehicle ${vehicle}`);
  else if (old !== false) console.log("left the vehicle");
});

ai-core:client:hudVisibleCopy Anchor Link

HUD’lar görünmeli ya da gizlenmeli: tam ekran bir arayüz açıldı ya da sonuncusu kapandı. Bir HUD resource’u bunu dinler.

Taraf: Client · Sabit: CORE.clientHudVisibleEvent · Lib: hud.onChange

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

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

hud.onChange((visible) => SendNUIMessage({ action: "visible", data: visible }));

ai-core:client:worldSyncCopy Anchor Link

Hava ve saat senkronu duraklatıldı ya da yeniden çalışıyor. Bir hava script’i bunu dinler. Bkz. Hava ve saat senkronu.

Taraf: Client · Sabit: CORE.clientWorldSyncEvent

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

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

on(CORE.clientWorldSyncEvent, (paused: boolean) => {
  console.log(paused ? "weather sync paused" : "weather sync running");
});

ai-core:client:definitionsCopy Anchor Link

Admin panelinde bir meslek ya da çete eklendi, değiştirildi veya silindi. Her client’ta, değişen her meslek ya da çete için bir kez tetiklenir. GetDefinitions export’uyla birlikte kullan.

Taraf: Client · Sabit: CORE.clientDefinitionsEvent

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

GetDefinitions örneğine bak.

ai-core:client:characterPortraitCopy Anchor Link

Karakter ekranındaki bir karakter kartı için bir portre resmi. Bir kıyafet script’i (ai-appearance) bunu tetikler; ai-core’un karakter ekranı dinler ve resmi gösterir. Yalnızca bir kıyafet script’i yazıyorsan kendin tetikle.

Taraf: Client · Sabit: CORE.clientCharacterPortraitEvent · Tetikleyen: kıyafet script’i, dinleyen ai-core

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

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

// Bir kıyafet script’i karakter ekranına bir portre verir.
export function sendPortrait(charId: number, txd: string): void {
  emit(CORE.clientCharacterPortraitEvent, charId, `https://nui-img/${txd}/${txd}`);
}

ai-core:client:keyHintsCopy Anchor Link

HUD’ların göstermesi gereken tuş ipuçları listesi değişti. Tüm yeni listeyi taşır. GetKeyHints export’uyla birlikte kullan.

Taraf: Client · Sabit: KEY_HINTS.changedEvent

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

GetKeyHints örneğine bak.

ai-core:client:seatbeltCopy Anchor Link

ai-core’un okuduğu emniyet kemeri script’i hangisiyse onda yerel oyuncunun emniyet kemeri değişti. Değişiklikleri bildiren script’lerden (ai-smallresources, qbx_seatbelt) tetiklenir; bir HUD’ın kendi kemeriyle ihtiyacın olduğunda GetSeatbelt’i oku.

Taraf: Client · Sabit: CORE.clientSeatbeltEvent · Lib: seatbelt.onChange

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

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

seatbelt.onChange((worn) => SendNUIMessage({ action: "belt", data: worn === true }));

ai-smallresources:seatbeltCopy Anchor Link

ai-smallresources’un kendi emniyet kemeri event’i. Yalnızca ai-smallresources’u destekleyen HUD’lar bunu dinler. Yeni kod, desteklenen her emniyet kemeri script’iyle çalışan yukarıdaki ai-core:client:seatbelt’i dinlemelidir.

Taraf: Client · Sabit: SEATBELT_EVENT

ArgümanlarCopy Anchor Link

DinleyiciCopy Anchor Link

import { SEATBELT_EVENT } from "@aicore-fivem/shared";

on(SEATBELT_EVENT, (worn: boolean | null) => console.log(`belt: ${worn}`));

Dahili client event’leriCopy Anchor Link

Lib’in Keybind’ı ai-core’un client’ıyla iki local event ile konuşur. Onları kendin tetikleme ya da cevaplama; Keybind (TS) ya da aiLib.Keybind (Lua) kullan.