ai-core client export’ları
ai-core’un client export’larının ne olduğu, onları TypeScript ve Lua’dan nasıl çağıracağın ve her birini hangi lib yardımcısının sardığı.
Bir client export’u, ai-core’un client tarafının aynı oyuncunun oyunundaki diğer her resource’a sunduğu bir fonksiyondur. Client script’in onu yerel oyuncunun verisini okumak, HUD’ı gizlemek, bir radyal menü öğesi eklemek, bir eşyayı kontrol etmek, bir emote oynatmak vb. için çağırır.
Bu export’ların çoğu katmandır: ai-core işi kendisi yapmaz, çağrıyı sunucunun o iş için çalıştırdığı script’e iletir (envanter, kıyafet script’i, radyal menü, emote menüsü, ölüm script’i, MDT). Script’in tek bir adı çağırır ve sunucu sahibi bu script’lerden birini başkasıyla değiştirdiğinde çalışmaya devam eder.
Başlamadan önce
- Her client export’u senkrondur: hemen cevap verir ve asla beklemez. Bu sayfalardaki hiçbir şey Promise döndürmez ve Lua’da hiçbir şey thread gerektirmez. Cevabı zaman isteyen tek export (
OpenItemPicker) bir event ile cevap verir. - Onları yalnızca client kodundan çağır. Server’ın kendi listesi vardır: ai-core server export’ları.
- ai-core başlatılmış olmalıdır. ai-core olmadan çalışabilecek bir resource TypeScript’te
optionalExport("ai-core")kullanır (ai-core durmuşkennull’dır). - Her export ilk harfinin büyük/küçük hali değiştirilmiş adıyla da cevap verir:
GetPlayerDatavegetPlayerDataaynı fonksiyondur. - Bir resource’un bu export’larla eklediği şeyler (HUD gizleme sebepleri, tuş ipuçları, radyal öğeler, dünya senkronu duraklatmaları) o resource’a aittir. Resource durduğunda ai-core onları kaldırır, böylece bir çökme ya da yeniden başlatma asla HUD’ı gizli ya da arkada ölü bir menü öğesi bırakmaz.
Export çağırmak
import { resourceExport } from "@aicore8/lib/client";
// Tek bir tipli tutamaç, dosyanın en üstünde. Tipler @aicore8/shared’dan (AiCoreClientExports) gelir.
const core = resourceExport("ai-core");
RegisterCommand(
"myjob",
() => {
const data = core.GetPlayerData();
console.log(data ? `job: ${data.job.job}` : "no character loaded");
},
false,
);Varsa lib yardımcısını kullan
Çoğu export’un @aicore8/lib/client içinde bir yardımcısı, Lua resource’ları için de aiLib üzerinde aynı yardımcısı vardır (shared_script '@ai-lib/init.lua'). Yardımcılar export’u senin için çağırır, cevabını kontrol eder ve varsa bir değişiklik dinleyicisi ekler. Onları tercih et; lib’i kullanamadığında export’u doğrudan çağır.
| Export | TypeScript lib | Lua aiLib | Sayfa |
|---|---|---|---|
GetPlayerData, IsPlayerLoaded, GetDefinitions | getPlayerData, onPlayerData | aiLib.playerData.get, aiLib.playerData.onChange | Oyuncu |
HideHud, ShowHud, IsHudVisible | hud.hide, hud.show, hud.visible, hud.onChange | aiLib.hud.hide, aiLib.hud.show, aiLib.hud.visible | HUD |
OpenHudSettings, HasHudSettings | yok | yok | HUD |
ShowKeyHint, HideKeyHint | keyHints.show, keyHints.hide | aiLib.keyHints.show, aiLib.keyHints.hide | Keybind’lar ve tuş ipuçları |
GetKeybindKey, GetKeyHints, OpenKeyboard | yok | yok | Keybind’lar ve tuş ipuçları |
PauseWorldSync, ResumeWorldSync | world.pauseSync, world.resumeSync | aiLib.world.pauseSync, aiLib.world.resumeSync | Hava ve saat senkronu |
OpenInventory, HasItem, GetCurrentWeapon | inventory.openInventory, inventory.hasItem, inventory.currentWeapon | aiLib.inventory.* (aynı adlar) | Eşyalar |
OpenItemPicker | itemPicker | aiLib.itemPicker | Eşyalar |
AddRadialItem, RemoveRadialItem, RefreshRadial | radial.add, radial.remove, radial.refresh | aiLib.radial.* (aynı adlar) | Radyal menü |
IsHandsUp, IsPointing, GetGestureProvider, PlayEmote, CancelEmote, GetEmoteProvider | gestures.* | aiLib.gestures.* | Hareketler ve emote’lar |
ApplyAppearance, GetPedAppearance, OpenClothingMenu, WearOutfit, ReloadSkin | appearance.apply, read, openMenu, wearOutfit, reloadSkin | aiLib.appearance.* (aynı adlar) | Görünüm |
IsDead | medical.isDead, medical.onChange | yok (export’u çağır) | Sağlık |
GetSeatbelt, GetSeatbeltProvider | seatbelt.isOn, seatbelt.provider, seatbelt.onChange | aiLib.seatbelt.* (aynı adlar) | Emniyet kemeri |
OpenMdt | mdt.open | aiLib.mdt.open | MDT |
ExternalNotify | yok (ai-lib kullanır) | yok | Bildirimler |
Export’ları her karede çağırma
Export’lar bir resource sınırını geçer, bu da yerel bir fonksiyon çağrısından daha pahalıdır. Bir değeri bir kez oku, sonra ne zaman değiştiğini söyleyen event’i izle. Her sayfa o event’i adlandırır; hepsi Event’ler ve durum sayfasında listelenir.
Menüler, girdi diyalogları, bildirimler, istemler, ilerleme çubuğu ve mini oyunlar ai-core’un değil, ai-lib’indir. Lib’in notify, menu, input, progress ve skillCheck’ini (ya da aiLib üzerindeki aynı adları) kullan.
vRP köprüsü
ai-core’un yerleşik vRP köprüsünün kullandığı export’lar - vRP’nin veri deposu, veritabanı API’si, yetki eşlemesi ve yetki listesi.
Oyuncu
Yerel oyuncunun karakterini, parasını, mesleklerini, mesaisini ve çetelerini oku, bir karakterin yüklü olup olmadığını kontrol et ve meslek ve çete tanımlarını oku.