Lib: server
@aicore8/lib/server ve aiLib’in server tarafı: ne oldukları, TypeScript ve Lua’da nasıl yüklendikleri ve tüm konu sayfaları.
Server lib’i, her ai-* server script’inin aynı kodu yeniden yazmak yerine kullandığı yardımcıların bütünüdür: client’lara güvenli cevap vermek, komutlar, oyuncular, eşyalar, araçlar, para, loglar ve admin paneli. Başka bir sisteme dokunan yardımcıların çoğu (envanter, anahtarlar, telefon, hapis...) ai-core üzerinden gider; böylece sunucu sahibi envanter ya da telefon script’ini değiştirdiğinde senin script’in çalışmaya devam eder.
TypeScript
resource/server/ altındaki dosyalarda @aicore8/lib/server’dan import et. Her tarafta çalışan yardımcılar (reddetmeler, girdi okuyucular, matematik) @aicore8/lib/shared’dan gelir.
import { onClientCallback, inventory, notify } from "@aicore8/lib/server";
import { fail, oneArg, readId } 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/server.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 server 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 kaydettiğin komutlar ve callback’ler senin resource’una aittir ve o durduğunda kaldırılır.
aiLib.addCommand('hello', { help = 'Says hello' }, function(source)
aiLib.notify(source, 'Hello!', 'success')
end)Bekler olarak işaretli Lua fonksiyonları (progressFor, minigameFor, spawnVehicle, triggerClientCallback, billing.unpaid, appearance.get) cevap gelene kadar kodu duraklatır. Yalnızca bir thread içinde çalışırlar. aiLib.onClientCallback ve aiLib.onClientEvent handler’ları zaten bir thread içinde çalışır; başka her yerde ç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: PendingActions, PlayerMap, Cooldowns, KeyedCooldowns, SourceLock, KeyWatchers, konum yardımcıları, AreaStream, state bag sınıfları, AdminPanel, DataFile ve veritabanı yardımcıları (Lua resource’ları SQL için ai-mysql’in oxmysql API’sini kullanır).
Konular
Client girdisi
onClientCallback, onClientEvent, korumalar, triggerClientCallback, progressFor, minigameFor, PendingActions.
Komutlar
addCommand: ayrıştırılmış argümanlar, yetkiler, sohbet önerileri.
Oyuncular ve karakterler
online, onCharacter, notify, yakındaki oyuncular, konumlar, PlayerMap, cooldown’lar, kilitler, hız sınırları.
Karakterler, yüklü olsun olmasın
characters: ai-core üzerinden her karakteri bul, oku ve değiştir - para, meslek, çete, metadata, ad, oynama süresi.
Eşyalar
inventory: verme, alma, sayma, depolar (stash), marketler, kullanılabilir eşyalar.
Araçlar
spawnVehicle, vehicleType, vehicleKeys, yakıt, garajlar, net id’den entity.
Para ve bankacılık
money.transfer, banking, billing.
Meslekler ve hizmetler
dispatch, prison, mdt, ems, medical, stress, needs, definitions, isPrimeTime.
Dünya
Saat ve hava, routing bucket’lar, kapılar, kayıtlı karakterler.
Telefon ve görünüm
Telefon numaraları, mailler, mesajlar; kayıtlı karakter görünümleri.
State bag’ler
EntityState, PlayerState, GlobalKey, GlobalGroup: replike edilen değerleri yazmak.
Loglar
aiLog, aiLogChannels: ai-core üzerinden Discord, Fivemanage ve daha fazlasına loglar.
Alan yayını
AreaStream: dünya nesneleri yalnızca yakınındaki oyunculara gönderilir.
Admin paneli
AdminPanel ve DataFile: script’inin ayarları ai-core’un panelinde.
Veritabanı
createDatabaseTables, WriteQueue.
Client ile paylaşılan yardımcılar
Server girişi /fivem yardımcılarını da yeniden export eder; bu yüzden onları @aicore8/lib/server’dan 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).
Server girişinden export edilen EntityState, PlayerState, GlobalKey ve GlobalGroup state bag sınıfları server sürümleridir: set eklerler. Bkz. State bag’ler.
Yalnızca ai-core’un kullandığı iki yardımcı
sendPlayerData(source, key, value) ve patchPlayerData(source, key, patch), bir oyuncunun verisinin (AiPlayerData) tek bir değerini o oyuncunun client’ına gönderir. Bunları ai-core çağırır; senin script’inin onlara hiç ihtiyacı olmaz. Oyuncu verisini client’ta getPlayerData ile oku (Lib: client).
Üyelik ve oyuncu verisi
hasJob, inGang, onDutyIn, allows, onMembershipChange, getPlayerData, onPlayerData ve seedPlayerData - ai-core’un gönderdiği haliyle yerel oyuncunun karakteri, parası, meslekleri, görev durumu ve çeteleri.
Client girdisi
Client’lara güvenli cevap ver: onClientCallback, onClientEvent, korumalar (guard), triggerClientCallback, server’ın doğruladığı ilerleme çubukları ve minigame’ler, PendingActions.