Resource’lar arası export’lar

Export, bir resource’un sunduğu ve diğer resource’ların çağırdığı bir fonksiyondur (exports["ai-core"].GetMoney(...)). Bu yardımcılar export’ları iki ad stiliyle kaydeder, diğer resource’lara tipli erişim verir ve kodunun çalışmayan bir resource’tan etkilenmeden devam etmesini sağlar.

import { registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted } from "@aicore-fivem/lib/fivem";
// Bir client ya da server dosyasında aynı adlar "@aicore-fivem/lib/client" ya da "@aicore-fivem/lib/server"’dan da gelir.

registerExportCopy Anchor Link

Bir fonksiyonu diğer resource’lara name adıyla ve ayrıca ilk harfin büyük/küçük hali değiştirilmiş aynı adla (GetPrice ve getPrice) sunar; böylece iki stilden birinde yazılmış script’ler onu bulur. FiveM’in exports(name, fn)’i yerine bunu kullan.

Taraf: Client ve server · Bekler: hayır

registerExport(name: string, handler: (...args: any[]) => unknown): void

Lua: karşılığı yok; FiveM’in kendi exports('GetPrice', function(...) end)’ini kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

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

const prices = new Map<string, number>([["water", 5], ["bread", 3]]);

// Diğer resource’lar: exports["my-shop"].GetPrice("water") ya da exports["my-shop"].getPrice("water")
registerExport("GetPrice", (item: unknown) => {
  const name = readText(item, 64);
  return name === null ? null : (prices.get(name) ?? null);
});

resourceExportCopy Anchor Link

Başka bir resource’un export’larına tipli erişim. Tipler @aicore-fivem/shared’daki CitizenExports’tan gelir (ai-core, ai-lib, ai-target, ai-vehicles, ai-inventory ve export’u olan diğer ai-* script’leri); böylece editörün her export’u, argümanlarını ve dönüş tipini bilir.

Taraf: Client ve server · Bekler: hayır

resourceExport<K extends keyof CitizenExports & string>(resource: K): CitizenExports[K]

Lua: karşılığı yok; exports['ai-core']:GetMoney(source, 'cash') kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Resource’un export nesnesi. Bir metodu çağırmak export’u çağırır.

ÖrnekCopy Anchor Link

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

// Dosya başına, en üstte bir handle.
const core = resourceExport("ai-core");

export function payBonus(source: number): boolean {
  return core.AddMoney(source, "bank", 500, "Bonus");
}

optionalExportCopy Anchor Link

resourceExport ile aynı tipli export’lar, ama resource başlamamışken null. İsteğe bağlı bir bağımlılık için kullan: sunucu o resource’u çalıştırmadığında script’in çalışmaya devam eder.

Taraf: Client ve server · Bekler: hayır

optionalExport<K extends keyof CitizenExports & string>(resource: K): CitizenExports[K] | null

Lua: karşılığı yok; çağırmadan önce GetResourceState('ai-vehicles') == 'started' kontrol et.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Resource başlamışken export nesnesi, aksi halde null.

ÖrnekCopy Anchor Link

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

function plateOfVehicleId(vehicleId: number): string | null {
  // Her seferinde tekrar sor: ai-vehicles server çalışırken başlayabilir ya da durabilir.
  return optionalExport("ai-vehicles")?.GetVehicle(vehicleId)?.plate ?? null;
}

callExportCopy Anchor Link

CitizenExports’ta tipi olmayan bir resource’un (üçüncü parti bir script) export’unu çağırır. Sonuç unknown’dur: kullanmadan önce biçimini kontrol et.

Taraf: Client ve server · Bekler: hayır

callExport(resource: string, name: string, ...args: unknown[]): unknown

Lua: karşılığı yok; exports[resource][name](nil, ...) ya da exports[resource]:Name(...) kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

unknown: export ne döndürdüyse.

ÖrnekCopy Anchor Link

import { callExport, isResourceStarted } from "@aicore-fivem/lib/client";

function otherHudVisible(): boolean {
  if (!isResourceStarted("some-hud")) return true;
  const visible = callExport("some-hud", "IsVisible");
  return typeof visible === "boolean" ? visible : true;
}

provideExportCopy Anchor Link

Resource’unun fxmanifest.lua dosyasında provide ile yerine geçtiği bir resource adı için exports["<resource>"].<name>’e cevap verir. FiveM’in provide’ı adın var olmasını sağlar (böylece dependency satırları geçer) ama export’larını iletmez; bu yardımcı o adın tek bir export’una cevap verir. ai-banking bunu qb-banking ve Renewed-Banking çağrılarına cevap vermek için kullanır.

Taraf: Client ve server · Bekler: hayır

provideExport(resource: string, name: string, fn: (...args: any[]) => unknown): void

Lua: karşılığı yok.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

provide 'old-banking'

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

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

// old-banking için yazılmış script’ler çalışmaya devam eder: exports["old-banking"].GetAccountBalance("police")
provideExport("old-banking", "GetAccountBalance", (job: unknown) => {
  const name = readText(job, 32);
  return name === null ? 0 : (core.GetSharedMoney("job", name, "bank") ?? 0);
});

isResourceStartedCopy Anchor Link

Bir resource’un şu an çalışıp çalışmadığı (durumu "started").

Taraf: Client ve server · Bekler: hayır

isResourceStarted(resource: string): boolean

Lua: karşılığı yok; GetResourceState(resource) == 'started' kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Resource başlamışken true. Durmuşsa, başlıyorsa, duruyorsa ya da kurulu değilse false.

ÖrnekCopy Anchor Link

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

if (!isResourceStarted("ai-inventory")) console.warn("ai-inventory is not running: shop items will not work.");