Zamanlama ve yaşam döngüsü

import { every, onStop, caller, ByResource, Reasons } from "@aicore-fivem/lib/fivem";
import { sleep, waitFor } from "@aicore-fivem/lib/shared";

Periyodik işlerCopy Anchor Link

everyCopy Anchor Link

Resource’unun tek zamanlayıcısından her ms milisaniyede bir (0 = her kare) bir fonksiyon çalıştırır. setInterval, setTick ya da Wait’li bir CreateThread döngüsü yerine bunu kullan: bir resource’un tüm görevleri tek bir tick’i paylaşır ve o tick yalnızca en az bir görev açıkken var olur; böylece boştaki bir resource resmon’da hiçbir maliyet getirmez.

Taraf: Client ve server · Bekler: hayır

every(ms: number, fn: () => unknown, options?: EveryOptions): Job

local job = aiLib.every(ms, fn, options) -- job:set(active), job:stop(), job.running

ParametrelerCopy Anchor Link

EveryOptionsCopy Anchor Link

Dönüş değeriCopy Anchor Link

Job: görevi açıp kapatmak için bir handle.

ÖrnekCopy Anchor Link

Yalnızca yapacak bir işi varken çalışan kare başı bir görev:

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

// Nişangahı her karede gizler, ama yalnızca elde silah varken.
const hideCrosshair = every(0, () => HideHudComponentThisFrame(14), {
  active: cache.weapon !== false,
  name: "hide crosshair",
});

onCache("weapon", (weapon) => hideCrosshair.set(weapon !== false));

BeklemekCopy Anchor Link

sleepCopy Anchor Link

ms milisaniye bekler.

Taraf: Client, server ve NUI · Bekler: evet (Promise)

sleep(ms: number): Promise<void>

Lua: karşılığı yok; bir thread içinde Wait(ms) kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

ms milisaniye sonra çözülen Promise<void>.

ÖrnekCopy Anchor Link

import { sleep } from "@aicore-fivem/lib/shared";
import { fadeOut, fadeIn } from "@aicore-fivem/lib/client";

async function blink(): Promise<void> {
  await fadeOut(300);
  await sleep(1000);
  await fadeIn(300);
}

waitForCopy Anchor Link

Bir koşulu bir değer verene kadar kontrol eder, sonra o değeri döndürür. Oyunun kendi zamanında yaptığı bir şeyi beklemek için kullan: bir entity’nin var olması, bir modelin yüklenmesi, bir değerin gelmesi.

Taraf: Client, server ve NUI · Bekler: evet (TypeScript’te Promise, Lua’da thread’i yield eder)

waitFor<T>(check: () => T | undefined, timeoutMs?: number | false, intervalMs?: number): Promise<T>

local value = aiLib.waitFor(check, timeout, interval) -- değer ya da zaman aşımından sonra nil; bir thread içinde çağır

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

TypeScript: check’in döndürdüğü, undefined olmayan ilk değerle çözülen Promise<T>. Zaman aşımından sonra Error("waitFor timed out after <ms> ms") ile reddedilir.

Lua: değer ya da zaman aşımından sonra nil (hata fırlatmaz).

ÖrnekCopy Anchor Link

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

async function vehicleFromNet(netId: number): Promise<number | null> {
  try {
    return await waitFor(() => {
      const vehicle = NetworkGetEntityFromNetworkId(netId);
      return DoesEntityExist(vehicle) ? vehicle : undefined;
    }, 5000);
  } catch {
    return null; // 5 saniye içinde stream edilmedi
  }
}

Resource yaşam döngüsüCopy Anchor Link

onStopCopy Anchor Link

Resource’un durduğunda (kodun çalıştığı tarafta) bir fonksiyon çalıştırır. Native’lerin oluşturduğu ve başka hiçbir şeyin kaldırmadığı şeyleri silmek için kullan: oluşturduğun entity’ler, kameralar, bir NUI odağı.

Taraf: Client ve server · Bekler: hayır

onStop(fn: () => void): void

Lua: karşılığı yok; AddEventHandler('onResourceStop', function(name) if name == GetCurrentResourceName() then ... end end) kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

import { onStop } from "@aicore-fivem/lib/server";

const spawned = new Set<number>();

onStop(() => {
  for (const entity of spawned) if (DoesEntityExist(entity)) DeleteEntity(entity);
});

callerCopy Anchor Link

Şu an çalışan export’u çağıran resource’un adı. Kendi kodunun içinde (bir export çağrısında değil) senin resource’unun adıdır.

Taraf: Client ve server · Bekler: hayır

caller(): string

Lua: karşılığı yok; GetInvokingResource() or GetCurrentResourceName() kullan.

Dönüş değeriCopy Anchor Link

string: çağıran resource’un adı ya da başka hiçbir resource çağırmıyorsa bu resource’un adı.

ÖrnekCopy Anchor Link

import { registerExport, caller } from "@aicore-fivem/lib/server";

registerExport("Ping", () => {
  console.log(`${caller()} asked for a ping`);
  return true;
});

ByResourceCopy Anchor Link

Girdileri onları ayarlayan resource’a ait olan bir map. O resource durduğunda girdileri hemen kaldırılır (ve her biri için onDrop çalışır). Diğer resource’ların senin export’ların üzerinden kaydettiği şeyler için kullan: hook’lar, istemler, eşyalar, menü girdileri.

Taraf: Client ve server · Bekler: hayır

new ByResource<K, V>(options?: { onDrop?: (resource: string, key: K, value: V) => void })

Lua: karşılığı yok.

ParametrelerCopy Anchor Link

MetotlarCopy Anchor Link

ÖrnekCopy Anchor Link

import { ByResource, registerExport } from "@aicore-fivem/lib/server";
import { readText } from "@aicore-fivem/lib/shared";

type Hook = (source: number, text: string) => boolean;
const hooks = new ByResource<string, Hook>({
  onDrop: (resource, id) => console.log(`${resource} stopped: hook ${id} removed`),
});

// Başka bir resource: exports["my-chat"].AddHook("swear-filter", (source, text) => ...)
registerExport("AddHook", (id: unknown, hook: unknown) => {
  const name = readText(id, 64);
  if (name === null || typeof hook !== "function") return false;
  hooks.set(name, hook as Hook); // sahip = AddHook’u çağıran resource
  return true;
});

export function allowed(source: number, text: string): boolean {
  for (const hook of hooks.values()) if (!hook(source, text)) return false;
  return true;
}

ReasonsCopy Anchor Link

En az bir sebep ayarlıyken açık olan bir anahtar. Her resource kendi adlandırılmış sebeplerini ayarlar ve duran bir resource’un sebepleri temizlenir. "HUD’u gizle", "senkronu duraklat", "menüyü engelle" için kullan: birkaç script aynı anda isteyebilir ve durum yalnızca sonuncusu bıraktığında geri döner.

Taraf: Client ve server · Bekler: hayır

new Reasons()

Lua: karşılığı yok.

MetotlarCopy Anchor Link

ÖrnekCopy Anchor Link

import { Reasons, registerExport } from "@aicore-fivem/lib/client";
import { readText } from "@aicore-fivem/lib/shared";

const hidden = new Reasons();
hidden.onChange((any) => SendNUIMessage({ action: "visible", value: !any }));

// Diğer resource’lar: exports["my-hud"].Hide("cutscene") ve exports["my-hud"].Show("cutscene")
registerExport("Hide", (reason: unknown) => {
  const name = readText(reason, 64);
  if (name !== null) hidden.set(name, true);
});
registerExport("Show", (reason: unknown) => {
  const name = readText(reason, 64);
  if (name !== null) hidden.set(name, false);
});