Event’ler ve durum
ai-core diğer script’lere bir şeyin değiştiğini nasıl söyler - local event’ler, net event’ler, state bag’ler - ve TypeScript ile Lua’da nasıl dinlenir.
ai-core bir şey değiştiğinde diğer script’lere söyler: bir karakter yüklendi, para hareket etti, bir meslek değişti, oyuncu yere düştü, HUD gizlendi. Script’in tekrar tekrar sormak yerine dinler. Bu bölüm diğer resource’ların kullandığı her event’i ve ortak durum değerini listeler.
Üç tür
| Tür | Nedir | Nasıl dinlenir |
|---|---|---|
| Local event | Bir tarafta (server ya da bir client) o taraftaki her resource için tetiklenir. Asla ağı geçmez. ai-core event’lerinin çoğu local’dir. | TS: on(name, handler). Lua: AddEventHandler(name, handler). |
| Net event | Server’dan bir oyuncunun client’ına (ya da tersi) gönderilir. | TS client: lib’den onServerEvent(name, ...). Lua client: aiLib.onServerEvent(name, handler). |
| State bag | GlobalState’te, bir oyuncuda ya da bir entity’de saklanan bir değer. Herkes okuyabilir; yalnızca sahibi olan resource yazar. | Lib’in GlobalKey, PlayerState, EntityState, GlobalGroup’u ya da Lua’da GlobalState[...], Player(src).state[...], Entity(e).state[...]. |
Sayfalar
| Sayfa | Ne |
|---|---|
| Server event’leri | Karakter yüklendi, doğdu, kaldırıldı; para, meslekler, mesai, çeteler, metadata; eşya kullanıldı; oyuncu öldü; meslek ve çete tanımları; envanter değişti. |
| Client event’leri | Yerel karakter yüklendi ya da kaldırıldı, yerde olma durumu, önbellekteki değerler, HUD görünürlüğü, dünya senkronu, tuş ipuçları, emniyet kemeri. |
| Net event’ler | Bir client’ın dinleyebileceği oyuncu verisi kanalı ve tetiklememen gereken ai-core’un kendi trafiği. |
| ai-lib arayüz event’leri | ai-lib’in export’larını kendileri çağıran script’ler için menülerin, girdi diyaloglarının, istemlerin ve ilerleme çubuğunun cevapları. |
| State bag’ler | PLAYER_BAGS, VEHICLE_BAGS ve ai-core’un yazdığı her GlobalState anahtarı. |
| Framework köprüsü event’leri | ai-core’un o framework’ler için yazılmış script’ler için tetiklediği ESX, QB / Qbox ve vRP event’leri ve cevapladığı framework event’leri. |
Adlar sabitlerden gelir
TypeScript’te bir event adını asla elle yazma. Onlar @aicore8/shared içinde sabitlerdir:
| Sabit | Event’ler |
|---|---|
CORE | ai-core’un server ve client event’leri (CORE.playerLoadedEvent, CORE.clientDeadEvent...) ve GlobalState anahtarları (CORE.pvpStateKey...). |
KEY_HINTS | KEY_HINTS.changedEvent. |
MENU_EVENTS, LIB_UI | ai-lib’in arayüz cevapları. |
VEHICLES_EVENTS | ai-vehicles’ın sahip akışı. |
VRP | VRP.configEvent. |
PLAYER_BAGS, VEHICLE_BAGS, INVENTORY_STATE_KEY, APPEARANCE_STATE_KEY, dutyCountKey(job)... | State bag anahtarları. |
Lua’da sabit yoktur: her event’in yanında gösterilen string’i kullan.
İlk dinleyici
import { CORE, type CharacterInfo } from "@aicore8/shared";
on(CORE.playerLoadedEvent, (src: number, character: CharacterInfo) => {
console.log(`${character.firstname} ${character.lastname} joined as ${src}`);
});Bir karakterin server’daki tüm yaşamı için (yüklendi, kaldırıldı ve resource’un yeniden başladığında zaten dünyada olan karakterler) iki event’i elle kullanmak yerine lib’in onCharacter({ loaded, unloaded })’ını (Lua’da aiLib.onCharacter) kullan. Geç başlayan bir resource, başlamadan önce tetiklenen event’leri kaçırır; onCharacter o karakterleri senin için yeniden oynatır.
ai-core’un local event’leri bilerek local’dir. Asla adlarından birini RegisterNetEvent (ya da onNet) yapma: bu, herhangi bir oyuncunun client’ının handler’ına sahte bir ai-core:moneyChanged ya da ai-core:playerLoaded tetiklemesine izin verir. Düz AddEventHandler / on yalnızca aynı tarafta tetiklenen event’leri duyar.
Bildirimler
ai-lib’in bildirim kartlarının ai-core üzerinden üçüncü taraf bir bildirim arayüzüne nasıl ulaştığı ve arkasındaki tek export.
Server event’leri
ai-core’un tetiklediği her server tarafı local event - karakterler, para, meslekler, mesai, çeteler, metadata, tanımlar, eşyalar, ölümler - TypeScript ve Lua’da argümanları ve dinleyicileriyle.