Lib
@aicore-fivem/lib - her ai-* script’inin yapı taşları ve Lua için ai-lib.
@aicore-fivem/lib, AI Core’da ox_lib’in yerini tutar: script’lerin elle yazacağı her şey burada; ölçek için yazılmış ve benchmark’larla kontrol edilmiş. TypeScript resource’lar içe aktarır (@aicore-fivem/lib/client, /server, /shared); Lua resource’lar ai-lib’den yükler (shared_script '@ai-lib/init.lua', sonra aiLib.<ad>); bundler kullanmayan JavaScript resource’lar @ai-lib/dist/client.js / server.js yükler.
Client ve sunucu girdisi
| Yardımcı | Ne |
|---|---|
onClientCallback, onClientEvent | Kapıdan geçen client istekleri: hız, koruyucular (isAdmin, hasCharacter, near), argüman ayrıştırıcı, aynı anda tek çağrı (lock). |
triggerServerCallback, callAction | Client tarafı; callAction çevrilmiş ret mesajını kendisi gösterir. |
fail("KEY"), ActionResult | Dil anahtarlı retler. |
readInt, readId, readText, readVec3, readVec4, oneArg | Client değerleri için katı okuyucular. |
progressFor | Sunucunun yürüttüğü süreli eylem: oyuncunun client’ında ai-lib’in ilerleme çubuğu; sadece orada bittiğinde ve sunucuda yeterli süre geçtiğinde true. |
minigameFor | Sunucu akışının istediği mini oyun (maymuncuk, beceri): kazandı, kaybetti ya da kırıldı; oyuncunun client’ında oynanır, sunucu yine kontrol eder. |
PendingActions | Sunucunun beklediği diyaloglar (bir notun metni): token, oyuncu çıkınca temizlenir. |
PlayerMap, Cooldowns, KeyedCooldowns, onCharacter | Oyuncu çıkınca ve karakter değişince kendini temizleyen oyuncu başına durum. |
Dünya
| Yardımcı | Ne |
|---|---|
Points | Oyuncuların kullandığı her yer: istem ya da hedef (sunucu sahibinin seçimi), NPC’ler, blip’ler, model noktaları (ATM, pompa), araç noktaları. |
Zones, Blips, LocalPed | Alanlar, blip’ler, yerel ped’ler. |
hasJob, inGang, onDutyIn, onMembershipChange | canShow için üyelik kontrolleri. |
player, cache, onCache | Yerel ped: çarpışma yüklemeli ışınlama, animasyonlar, dondurma; önbellekteki ped, araç, koltuk, silah. |
spawnVehicle, vehicleKeys, vehicleFromNet, pedFromNet | Plaka, anahtar, yakıt, görünüm ve koltuklarla tek çağrıda sunucu aracı. |
EntityState, PlayerState, GlobalKey, GlobalGroup | Okuma başına maliyeti olmayan state bag’ler. |
raycast, groundZ, locationName, vehicleLabel, pedHeadshot | Yoklamalar ve isimler. |
AreaStream, AreaFollower | Dünyadaki nesneler (yere atılanlar, bitkiler, uyuyan bedenler, prop’lar) çevresindeki oyunculara akar: oyuncunun çevresindeki hücrelerin bir anlık görüntüsü, sonra sadece değişenler. |
Arayüz ve akış
| Yardımcı | Ne |
|---|---|
notify, progress, menu, input, itemPicker | Ortak arayüz, ai-lib çizer (eşya seçiciyi ai-core). progress animasyon ya da senaryo, dönülecek bir nokta, engellenen tuşlar, dondurma ve iptal tuşu alır. |
skillCheck, lockpick | ai-lib’in çizdiği mini oyunlar: beceri halkası (ox_lib’in zorluk biçimi) ve pim ve maymuncuk sayılı kilit açma. |
NuiScreen | Bir resource’un tam ekran sayfası: odak, gizlenen HUD’lar, kapanma mesajı ve sayfanın callback’leri tek sınıfta. |
Keybind, addCommand | Tuşlar (panelde ve tuş listesinde görünür) ve komutlar (ACE ile kontrol, panelde listelenir). |
every(ms, fn) | Periyodik işler için resource’un tek zamanlayıcısı. |
hud, keyHints, radial, controls | Tam ekran arayüzde HUD’ları gizleme, tuş yardımı, radyal öğeler, engellenen tuşlar. |
AI Core üzerinden
inventory, vehicleKeys, dispatch, phone, world (saat ve hava), prison, medical, appearance, money.transfer, buckets, online (oyuncular, meslekler, mesai, isimler), isPrimeTime: her biri sunucunun o iş için kullandığı script’e iletir.
Tam ve güncel liste sunucu klasöründeki .claude/rules/lib.md dosyasında.