Net event’ler
Bir client script’inin dinleyebileceği net event’ler (ai-core’un oyuncu verisi kanalı) ve diğer script’lerin tetiklememesi gereken ai-core’un kendi ağ trafiği.
Bir net event server ile bir oyuncunun client’ı arasında gider. ai-core bunlardan çok azını gönderir: bir oyuncunun kendi verisi karakter yüklendiğinde bir kez, sonra yalnızca değişen değerler ve yalnızca o oyuncuya gider. Script’inin ihtiyaç duyduğu diğer her şey bir client event’i ya da bir state bag’dir.
Bu event’lere nadiren doğrudan ihtiyacın olur. Lib’in onPlayerData(key, handler)’ı (TypeScript) ve aiLib.playerData.onChange(key, handler) (Lua) ikisini de senin için dinler, para ve metadata yamalarını birleştirir ve başlangıç değerlerini ai-core’dan okur.
ai-core:client:playerData
Server oyuncunun kendi verisinin tek bir değerini gönderir: tek bir anahtarın tüm değeri. Karakter yüklendiğinde anahtar başına bir kez, sonra o değer her değiştiğinde tetiklenir (bir meslek, mesai, bir çete...).
Taraf: Server’dan oyuncunun kendi client’ına
Argümanlar
Prop
Type
Dinleyici
import { onPlayerData } from "@aicore-fivem/lib/client";
// Lib ai-core:client:playerData ve playerDataPatch’i senin için dinler.
onPlayerData("job", (job) => console.log(`main job: ${job.job} grade ${job.grade}`));ai-core:client:playerDataPatch
Server bir harita değerinin yalnızca değişen kayıtlarını gönderir: money (bir hesabın yeni bakiyesi) ya da metadata (tek bir anahtar). Yamayı elindekiyle birleştir.
Taraf: Server’dan oyuncunun kendi client’ına
Argümanlar
Prop
Type
Dinleyici
import { getPlayerData, onPlayerData } from "@aicore-fivem/lib/client";
// Lib yamaları birleştirir: handler birleştirilmiş tüm para haritasını alır.
const show = (money: Record<string, number>): void => SendNUIMessage({ action: "cash", data: money.cash ?? 0 });
show(getPlayerData("money") ?? {});
onPlayerData("money", show);Bir client’ta net event’leri yalnızca lib’in onServerEvent’i (TypeScript) ya da aiLib.onServerEvent (Lua) üzerinden dinle. Event’in gerçekten server’dan geldiğini kontrol ederler; çıplak bir RegisterNetEvent handler’ı başka bir client resource’u adı yerel olarak tetiklediğinde de çalışır.
ai-core’un kendi trafiği: tetikleme
Bu net event’ler ve callback’ler, ai-core’un server’ı ile client’ı (ya da lib) arasındaki dahili trafiğidir. Loglarda tanıyabilmen için listelenmiştir. Onları asla başka bir script’ten tetikleme ve üzerlerine bir şey kurma: argümanları değişebilir.
| Ad | Yön | Ne |
|---|---|---|
ai-core:client:spawn | server’dan client’a | Yüklü karakteri dünyaya koyar. |
ai-core:client:chooseSpawn | server’dan client’a | Oyuncunun seçeceği doğma seçenekleri. |
ai-core:client:openCharacters | server’dan client’a | Bir değişimden sonra karakter ekranını yeniden gösterir. |
ai-core:client:characterLooks | server’dan client’a (latent) | Karakter ekranının görünümleri. |
ai-core:client:bills | server’dan client’a | Fatura listesi için oyuncunun açık ai-core faturaları. |
ai-core:client:stress | server’dan client’a | Stresi yalnızca kendi client’ından alan bir HUD için stres. |
ai-core:client:vehicleKeys, ai-core:client:garages | server’dan client’a | Yalnızca client API’si olan anahtar ve garaj script’leri için çağrılar. |
ai-core:clientError, ai-core:fuelReport | client’tan server’a | Client paketlerinin hata raporları; client tarafı yakıt script’lerinden yakıt seviyeleri. |
ai-core:characters, ai-core:createCharacter, ai-core:deleteCharacter, ai-core:selectCharacter, ai-core:spawnChoice, ai-core:payBill, ai-core:vehicleType | callback’ler | Karakter ekranı, doğma seçimi, faturalar ve araç spawn’ı. |
ai-core:admin:*, <resource>:admin:world | ikisi de | Admin paneli ve her resource’un panel verisi. |
ai-lib:client:notify, ai-lib:progressFor, ai-lib:minigameFor, ai-lib:client:progressForCancel | server’dan client’a | ai-lib’in bildirimleri, server’ın çalıştırdığı ilerleme çubukları ve mini oyunlar (lib’in notify, progressFor, minigameFor’unu kullan). |
Client event’leri
ai-core’un tetiklediği her client tarafı local event - yerel karakter yüklendi ya da kaldırıldı, yerde olma durumu, önbellekteki değerler, HUD görünürlüğü, dünya senkronu, meslek tanımları, tuş ipuçları, emniyet kemeri - argümanları ve dinleyicileriyle.
ai-lib arayüz event’leri
Bir oyuncu bir menüyü, girdi diyaloğunu, eşya seçiciyi, mini oyunu ya da istemi cevapladığında veya bir ilerleme çubuğunu iptal ettiğinde ai-lib’in tetiklediği client event’leri - ai-lib’in export’larını kendileri çağıran script’ler için.