AI Core
API başvurusuLib: client

Lib: client

@aicore8/lib/client ve aiLib’in client tarafı: ne oldukları, TypeScript ve Lua’da nasıl yüklendikleri ve tüm konu sayfaları.

Client lib’i, her ai-* client script’inin native’leri elle yazmak yerine kullandığı yardımcıların bütünüdür: server ile konuşmak, yerel oyuncu, etkileşim noktaları, bölgeler (zone), ped’ler ve blip’ler, ortak arayüz (bildirimler, ilerleme çubuğu, menüler, minigame’ler), tuş atamaları (keybind) ve sunucunun çalıştırdığı HUD, ölüm, kıyafet ya da emote script’i hangisiyse ona ai-core üzerinden ulaşan katmanlar.

TypeScript

resource/client/ altındaki dosyalarda @aicore8/lib/client’tan import et. Her tarafta çalışan yardımcılar (reddetmeler, girdi okuyucular, matematik, RecordObjects, ServerClock) @aicore8/lib/shared’dan gelir.

resource/client/index.ts
import { Points, notify, progress, cache } from "@aicore8/lib/client";
import { RecordObjects, ServerClock } from "@aicore8/lib/shared";

ai-core şablonundan yapılan her resource pakete zaten bağlıdır (package.json içinde "@aicore8/lib": "workspace:*"); build onu dist/client.js içine paketler.

Lua

Lua resource’ları aynı yardımcıları ai-lib resource’undan gelen global aiLib tablosunda bulur. fxmanifest.lua dosyana iki satır ekle:

fxmanifest.lua
dependency 'ai-lib'
shared_script '@ai-lib/init.lua'

Sonra herhangi bir client dosyasında aiLib.<name> çağır. Her modül ilk kullandığında yüklenir ve senin resource’unun içinde çalışır; bu yüzden oluşturduğun noktalar, keybind’ler ve callback’ler senin resource’una aittir ve o durduğunda kaldırılır. Sınıflar .new() ile oluşturulur ve metotları iki nokta üst üste ile çağrılır: local points = aiLib.Points.new(), sonra points:add(...).

client.lua
local t = aiLib.locale()

RegisterCommand('hello', function()
    aiLib.notify(t('HELLO'), 'success')
end, false)

Bekler olarak işaretli Lua fonksiyonları (triggerServerCallback, callAction, progress, menu.show, input, skillCheck, lockpick, itemPicker, fadeOut, fadeIn, player.teleport, waitForEntity, request* yükleyicileri, pedHeadshot) cevap gelene kadar kodu duraklatır. Yalnızca bir thread içinde çalışırlar. Komut handler’ları ve net event handler’ları zaten bir thread içinde çalışır; başka her yerde (bir noktanın onPressed’i, bir keybind, bir menü callback’i) çağrıyı CreateThread(function() ... end) ile sar.

Her TypeScript yardımcısının bir Lua karşılığı yoktur. Karşılığı olmayan her girdi bunu belirtir. Lua’da eksik olanlar: fromServer, isActionOk, replyError, onCache (Lua’da cache.onChange var), readPlayerState, readWeapon, player.holdAnim, attachProp, PreviewVehicle, NuiScreen, hud.onChange, controls.isDisabled, medical, fuel, drivenVehicle, entityFromNetId, araç props yardımcıları, ScriptCamera, TickLoop (aiLib.every(0, fn) kullan), AreaFollower, ServerClock, AdminWorld, RecordObjects ve üyelik kontrolleri (hasJob, inGang, onDutyIn, allows, onMembershipChange).

Konular

Server ile paylaşılan yardımcılar

Client girişi /fivem yardımcılarını da yeniden export eder; bu yüzden onları @aicore8/lib/client’tan da import edebilirsin. Bunlar Lib: shared ve fivem sayfasında bir kez belgelenir:

registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted, createLocale, loadLocaleTexts, LOCALE_CONVAR, ByResource, caller, onStop, plateOf, Reasons, every (EveryOptions ve Job tipleriyle), stateBoolean, stateNumber, stateString (tip StateParse).

Client girişinden export edilen EntityState, PlayerState, GlobalKey ve GlobalGroup state bag sınıfları salt okunur client sürümleridir: get(id) ve onChange(handler), set yok. Server sürümleri State bag’ler sayfasındadır.

Script’inin hiç çağırmadığı export’lar

ZoneEngine (Zones’un arkasındaki bölge denetleyicisi), ModelScanner ve readModelScanDef (Points.addModel’in arkasındaki model taraması), onları her resource için çalıştıran ai-lib için export edilir. Bunların yerine Zones ve Points kullan.

Bu sayfada