AI Core
API başvurusuEvent’ler ve durum

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ürNedirNasıl dinlenir
Local eventBir 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 eventServer’dan bir oyuncunun client’ına (ya da tersi) gönderilir.TS client: lib’den onServerEvent(name, ...). Lua client: aiLib.onServerEvent(name, handler).
State bagGlobalState’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

SayfaNe
Server event’leriKarakter 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’leriYerel 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’lerBir client’ın dinleyebileceği oyuncu verisi kanalı ve tetiklememen gereken ai-core’un kendi trafiği.
ai-lib arayüz event’leriai-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’lerPLAYER_BAGS, VEHICLE_BAGS ve ai-core’un yazdığı her GlobalState anahtarı.
Framework köprüsü event’leriai-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:

SabitEvent’ler
COREai-core’un server ve client event’leri (CORE.playerLoadedEvent, CORE.clientDeadEvent...) ve GlobalState anahtarları (CORE.pvpStateKey...).
KEY_HINTSKEY_HINTS.changedEvent.
MENU_EVENTS, LIB_UIai-lib’in arayüz cevapları.
VEHICLES_EVENTSai-vehicles’ın sahip akışı.
VRPVRP.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

resource/server/index.ts
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.

Bu sayfada