Server export’ları
ai-core’un server export’larını Lua ve TypeScript’ten nasıl çağıracağın ve her export grubunun listesi.
ai-core framework resource’udur. Diğer resource’lar ondan bir oyuncunun karakterini, parasını, mesleklerini ve eşyalarını ister ve ona "bu oyuncuya bir anahtar ver" ya da "bir polis ihbarı gönder" gibi işler gönderir. Bunu export’lar üzerinden yaparlar: ai-core’un sunucudaki başka herhangi bir resource’tan çağrılabilir yaptığı fonksiyonlar.
Bu sayfalar ai-core’un kaydettiği her server export’unu konuya göre gruplanmış olarak listeler. Her kayıt export’un ne yaptığını, tam imzasını, her parametresini, her durumda ne döndürdüğünü ve TypeScript ile Lua’da çalışan bir örneği gösterir.
Export çağırmak
Bir export, sahibi olan resource’un adı (ai-core) ve export’un adıyla çağrılır.
import { resourceExport } from "@aicore8/lib/server";
// Dosya başına bir tipli tutamaç, en üstte. Burada güvenlidir: FiveM her export’u
// ilk kullanımda arar ve ai-core yeniden başladığında unutur.
const core = resourceExport("ai-core");
export function cashOf(source: number): number {
return core.GetMoney(source, "cash") ?? 0;
}Başlamadan önce bilmen gerekenler:
- TypeScript tipleri.
resourceExport("ai-core"),@aicore8/sharediçindekiAiCoreServerExports’tan tiplenir, böylece editörün her adı, parametreyi ve dönüş tipini bilir. Bir fonksiyonun içinde aslaresourceExport("ai-core").GetMoney(...)yazma: tek tutamacı dosyanın en üstünde tut. - Lua iki nokta üst üste kullanır. Nokta değil,
exports['ai-core']:GetMoney(source, 'cash')yaz.nullcevabı Lua’yanilolarak, dizi bir Lua listesi olarak (ilk indeks 1), nesne bir tablo olarak gelir. - İki yazım. Her export ilk harfinin büyük/küçük hali değiştirilmiş adıyla da cevap verir:
GetMoneyvegetMoneyaynı fonksiyondur. - Export’lar asla beklemez. Her export küçük bir değerle hemen cevap verir. Cevap veritabanına ihtiyaç duyduğunda (kayıtlı bir görünüm, bir fatura listesi) export bir Promise döndürmek yerine bir
donecallback’i alır, çünkü bir Promise bir resource’tan diğerine geçemez. - Sık çalışan yollarda değil. Bir export çağrısı argümanlarını ve cevabını kopyalar. Export’ları her karede ya da bir döngüde her oyuncu için çağırma. "Kim mesaide", bir karakterin adı ya da birçok oyuncunun meslekleri için ai-core’un event’lerini izleyen lib’in
onlineaynasını kullan (Lib: server). - ai-core önce çalışmalı.
fxmanifest.luadosyanadependency 'ai-core'koy (bir ai-* resource’u onupackage.jsonfxDependenciesiçinde listeler), böylece resource’un ai-core’dan sonra başlar. sourceoyuncunun server id’sidir. FiveM’in bağlı bir oyuncuya verdiği numaradır. Karakter id’si (charId) farklı bir numaradır: veritabanındaki karakter satırının id’si.
Lib mi, export mu?
Çoğu export’un @aicore8/lib/server içinde bir sarmalayıcısı vardır (birçoğunun da Lua’nın aiLib’inde). Sarmalayıcı aynı export’u çağırır, bu yüzden davranış aynıdır; yalnızca daha güzel okunur (core.AddItem(source, "water") yerine inventory.addItem(source, "water")) ve güvenli olduğu yerlerde callback’leri Promise’e çevirir. Her kayıt sarmalayıcısını Lib satırında adlandırır. Hangisini istersen kullan; ai-lib’siz bir Lua resource’u export’u doğrudan çağırır.
Bu sayfalardaki örnekler
Örnekler eksiksiz server dosyalarıdır. TypeScript örnekleri lib’in addCommand ve onClientCallback’ini kullanır; Lua örnekleri ai-lib’in aiLib.addCommand ve aiLib.onClientCallback’ini kullanır, bunlar için fxmanifest.lua dosyanda şu satırlar gerekir:
shared_script '@ai-lib/init.lua'
dependency 'ai-lib'
dependency 'ai-core'Bekleyen Lua çağrıları (aiLib.progressFor, Wait) yalnızca bir thread içinde çalışır; komut ve callback handler’ları zaten bir thread içinde çalışır.
Tipler
Birkaç sayfada görünen tipler (CharacterInfo, InventoryRef, DispatchAlert...) her alanıyla Tipler sayfasında bir kez belgelenir ve onları kullanan her kayıttan bağlantı verilir.
Export grupları
Karakterler ve oyuncular
Oyuncu verisi, karakterler, server id aramaları, karakter değiştirme, çevrimdışı konumlar, kapsamdaki oyuncular.
Kayıtlı karakterler
Yüklü olsun olmasın her karakter: bul, oku, parası, meslekleri, çeteleri, metadata, ad, oynama süresi, kaydet, sil.
Para ve hesaplar
Bakiyeler, para ekleme ve çıkarma, meslek ve çete hesapları, transferler, hesap tipleri.
Meslekler ve çeteler
Üyelikler, mesai, rütbeler, mesaideki sayıları, prime time, meslek ve çete tanımları.
Metadata ve ayarlar
Bir karakterin metadata çantası, sunucunun markası, güncel olmayan script’ler.
Eşyalar
Eşya ekleme, çıkarma, sayma ve kontrol etme, stash’ler, script dükkanları, kullanılabilir eşyalar, eşya tanımları.
Araç anahtarları
Hangi anahtar script’i çalışıyorsa onun üzerinden araç anahtarı ver, al ve kontrol et.
Yakıt
Hangi yakıt script’i çalışıyorsa onun üzerinden bir aracın yakıtını oku ve ayarla.
Kapı kilitleri
Hangi kapı kilidi script’i çalışıyorsa onun üzerinden kapıları kilitle, aç ve oku.
Garajlar
Araç çekme, park etme, garaj menüsü açma, bir oyuncunun garajdaki araçlarını listeleme.
Sağlık
Canlandır, iyileştir ve bir oyuncunun yerde olup olmadığını kontrol et.
EMS
Kaç sağlıkçının boş olduğu, yardım çağrıları.
Görünüm
Hangi kıyafet script’i çalışıyorsa ondan bir karakterin kayıtlı görünümü.
Telefon
Telefon numaraları, mailler, mesajlar ve telefon bildirimleri.
İhbar
Hangi ihbar sistemi çalışıyorsa onun üzerinden polis ve meslek ihbarları.
MDT
Polis MDT’sindeki cezalar, arama kararları, tutuklamalar ve hapis kayıtları.
Hapishane
Hapse atma, serbest bırakma ve kalan süre.
Banka
Banka ekranı açma, bir mesleğin şirket bakiyesi.
Faturalar
Fatura gönderme, bir oyuncunun açık faturalarını listeleme ve ödeme.
Stres ve ihtiyaçlar
Stres ekleme ya da azaltma, açlık ve susuzluğu doldurma.
Saat ve hava
Hava, oyun saati, karartma ve dondurulmuş zaman.
Routing bucket’lar
Ayrı bir dünya için boş bir routing bucket alma ve geri verme.
Loglar
Discord’a, Fivemanage’e, FiveM Stats’e ve konsola log gönderme.
Bağlantı kontrolleri
Bağlanan her oyuncunun geçtiği kontroller, başkalarının yerine geçen script’ler.
Admin paneli ve komutlar
Panel kaydı, Commands sekmesi, lookup listeleri, harici ayar ekranları.
vRP köprüsü
ai-core’un yerleşik vRP köprüsünün kullandığı export’lar.
İlgili sayfalar
- Client export’ları: ai-core’un oyuncunun kendi oyununda cevapladıkları.
- Event’ler ve durum: ai-core’un tetiklediği event’ler (
ai-core:playerLoaded,ai-core:moneyChanged...); resource’unun tekrar sormak yerine değişiklikleri izlemesini sağlar. - Lib: server: her kayıtta adı geçen sarmalayıcılar.
API’ye genel bakış
Başka bir script’ten AI Core nasıl çağrılır - export’lar, event’ler ve lib, TypeScript ve Lua ile.
Karakterler ve oyuncular
Yüklü bir oyuncunun verisini ve karakterini oku, karakter id’si ya da citizen id ile bir oyuncu bul, karakter değiştir, çevrimdışı bir karakteri taşı, kapsamdaki oyuncular.