ai-lib
Her script’in kullandığı ortak oyuncu arayüzü (bildirimler, ilerleme çubuğu, istemler, menüler, giriş pencereleri, mini oyunlar) ve Lua ile JavaScript resource’ları için AI Core yardımcıları.
ai-lib iki iş yapar:
- Her script’in ortak kullandığı oyuncu arayüzü. Bildirim kartları, ilerleme çubuğu ve iptal tuşu, ekranın sağındaki istemler ve etkileşim tuşu, menüler, giriş pencereleri, maymuncuk ve beceri kontrolü mini oyunları. Her
ai-*script’i, AI Core’un köprüsü (ESX ve QB script’leri) ve senin kendi script’lerin onun üzerinden çizer; böylece bütün sunucu aynı görünür. - Diğer resource’lar için AI Core yardımcıları. Bir Lua resource’u manifest’ine tek satır ekler ve
aiLib.notify,aiLib.Points,aiLib.addCommand,aiLib.progressve diğerlerini alır. Düz JavaScript resource’ları onun paketlerini yükler. Lua script’leri AI Core’u TypeScript script’leri gibi bu sayede kullanır.
Arayüz ai-core olmadan çalışır, yani ai-lib’i tek başına kullanabilirsin. Oyuncuları, parayı ya da eşyaları okuyan yardımcılar ai-core gerektirir.
Oyunda ne yapar
- Bildirimler. Dört türde kart (başarı, hata, bilgi, uyarı), varsayılan 4 saniye.
- İlerleme çubuğu. Her script için tek bir çubuk. Oyuncu iptal edilebilir bir eylemi Backspace ile iptal eder.
- İstemler. Sağda ya da dünyadaki bir noktanın (bir kapı) üzerinde süzülen "E’ye bas ..." kutuları. Her script için tek bir etkileşim tuşu (E); en yeni istem en üsttedir.
- Menüler ve giriş pencereleri. Simgeli listeler, alt menüler (Escape geri gider, Escape’i basılı tutmak kapatır), anahtarlar ve metin ile sayı alanlı formlar.
- Mini oyunlar. Bir maymuncuk (maymuncuğu oynat, kilidi çevir) ve bir beceri kontrolü (yeşilde bas).
- Her zaman üstte. Menüler ve bildirimler, karakter ekranı dahil diğer her ekranın üzerinde görünür.
Kurulum
AI Core txAdmin tarifi kurar. Elle: klasörü resources/[ai]/ içine koy ve server.cfg dosyasına, AI Core çalıştırıyorsan ensure ai-core satırından sonra, ensure ai-lib ekle. OneSync gerektirir. Veritabanı tablosu yoktur.
Panel ayarları
ai-lib’in kendi sekmesi yoktur. AI Core’un General sekmesindeki iki ayar onu değiştirir:
| Ayar (General sekmesi) | Neyi değiştirir | Varsayılan |
|---|---|---|
| Notifications card, Notification script | Bildirim kartlarının nerede göründüğü: ai-lib’in kendi kartları ya da kurduğun başka bir bildirim script’i. O script durunca ai-lib’in kartları geri gelir. İstemler her zaman ai-lib’in kalır. | ai-lib |
| Interaction card, Interaction style | Prompt and key (ai-lib’in istemleri) ya da Target eye (ai-target gibi bir hedef script’i). | Prompt and key |
Komutlar
Yok.
Tuşlar
| Varsayılan tuş | Ne yapar | GTA ayarlarındaki adı |
|---|---|---|
| E | En üstteki istemi (ya da odaklanılan hedef işaretini) kullanır | Interact with the prompt on screen |
| Backspace | Süren eylemi iptal eder (buna izin veren bir ilerleme çubuğu) | Cancel the running action |
Herkes için varsayılanı panelin Keybinds sekmesinden değiştir; her oyuncu kendininkini GTA’nın tuş ayarlarından değiştirebilir.
Diğer script’lerle çalışır
- ESX ve QB arayüzü. AI Core’un köprüsü
esx_context,esx_textui,esx_notify,esx_progressbar,esx_menu_*,qb-menu,qb-inputveprogressbarresource’larını ai-lib’in menüleri, istemleri, kartları ve çubuğuyla çizer; böylece bu script’ler sunucunun geri kalanı gibi görünür. - Diğer bildirim script’leri kartları devralabilir (yukarıdaki General sekmesi).
Bilinen sınırlar
- Menü simge adları sabit bir Font Awesome listesidir; bilinmeyen bir ad nokta olarak görünür.
- Lua resource’ları kendi bölgelerini ve model noktalarını kendileri kontrol eder; JavaScript resource’ları kendilerininkini ai-lib’e verir, o da hepsini tek bir zamanlayıcıyla kontrol eder.
Geliştiriciler için ai-mysql
ai-mysql’in cevapladığı oxmysql export’ları, her birinin ne döndürdüğü, promise biçimleri, MySQL.lua sarmalayıcısı ve hata event’leri.
Geliştiriciler için ai-lib
ai-lib’i bir Lua ya da JavaScript resource’unda yüklemek, lib referansının nerede olduğu ve ai-lib’in kendi client export’ları ile event’leri.