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.
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:
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(...).
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 konuşmak
triggerServerCallback, onServerEvent, onServerCallback, callAction, bir ActionResult okumak.
Yerel oyuncu
cache ve onCache, player (koordinatlar, ışınlanma, animasyonlar), kararmalar (fade), playerPed, nearestPlayer.
Etkileşim noktaları
Points: add, addModel, addVehicle, her seçenek, prompt ya da target, refresh, panel kayıtlarından noktalar.
Bölgeler
Zones: giriş ve çıkış callback’leri olan alanlar; küre, silindir ve çokgen şekiller.
Ped’ler, blip’ler ve prop’lar
LocalPed, Blips, createBlip, attachProp, PreviewVehicle, player.holdAnim.
Ortak arayüz
notify, progress, menu, input, istemler, skillCheck, lockpick, itemPicker.
Ekranlar ve kontroller
NuiScreen, hud, keyHints, controls.
Keybind’ler
Keybind: varsayılanını admin panelinin değiştirebildiği, yeniden atanabilir bir tuş.
ai-core üzerinden katmanlar
medical, appearance, gestures, seatbelt, fuel, mdt, radial, world, inventory.
Araçlar ve entity’ler
nearestVehicle, drivenVehicle, waitForEntity, entityFromNetId, araç props.
Sorgular ve yükleme
raycast, groundZ, locationName, vehicleLabel, waypoint, pedHeadshot, onShot, requestModel ve benzerleri.
Kamera ve zamanlama
ScriptCamera, TickLoop, AreaFollower, ServerClock.
Üyelik ve oyuncu verisi
hasJob, inGang, onDutyIn, allows, onMembershipChange, getPlayerData, onPlayerData.
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.
Framework köprüsü event’leri
O framework’ler için yazılmış script’ler çalışmaya devam etsin diye ai-core’un tetiklediği ESX, QB / Qbox ve vRP event’leri, tam argümanlarıyla, ve ai-core’un cevapladığı framework event’leri.
Server ile konuşmak
Server’a sor ve cevabını bekle, çevrilmiş reddetmelerle server aksiyonları çalıştır, server event’lerini dinle ve server callback’lerine cevap ver.