Eventos e estado
Como o ai-core avisa outros scripts de que algo mudou - eventos locais, net events, state bags - e como escutar em TypeScript e Lua.
O ai-core avisa outros scripts quando algo muda: um personagem carregou, o dinheiro se moveu, um emprego mudou, o jogador caiu, o HUD se escondeu. Seu script escuta em vez de perguntar repetidamente. Esta seção lista cada evento e valor de estado compartilhado que os outros recursos usam.
Os três tipos
| Tipo | O que é | Como escutar |
|---|---|---|
| Evento local | Disparado num lado (servidor ou um cliente) para cada recurso desse lado. Nunca cruza a rede. A maioria dos eventos do ai-core é local. | TS: on(name, handler). Lua: AddEventHandler(name, handler). |
| Net event | Enviado do servidor para o cliente de um jogador (ou o contrário). | Cliente TS: onServerEvent(name, ...) da lib. Cliente Lua: aiLib.onServerEvent(name, handler). |
| State bag | Um valor guardado no GlobalState, num jogador ou numa entidade. Todos podem lê-lo; só o recurso dono o escreve. | GlobalKey, PlayerState, EntityState, GlobalGroup da lib, ou GlobalState[...], Player(src).state[...], Entity(e).state[...] em Lua. |
Páginas
| Página | O quê |
|---|---|
| Eventos de servidor | Personagem carregado, spawnado, descarregado; dinheiro, empregos, serviço, gangues, metadata; item usado; jogador morreu; definições de empregos e gangues; inventário trocado. |
| Eventos de cliente | O personagem local carregado ou descarregado, estado de caído, valores em cache, visibilidade do HUD, sincronização do mundo, dicas de teclas, cinto de segurança. |
| Net events | O canal de dados do jogador que um cliente pode escutar, e o tráfego próprio do ai-core que você não deve disparar. |
| Eventos de UI do ai-lib | Respostas de menus, caixas de entrada, prompts e da barra de progresso, para scripts que chamam os exports do ai-lib eles mesmos. |
| State bags | PLAYER_BAGS, VEHICLE_BAGS e cada chave de GlobalState que o ai-core escreve. |
| Eventos da ponte de frameworks | Os eventos de ESX, QB / Qbox e vRP que o ai-core dispara para scripts escritos para esses frameworks, e os eventos de framework que ele responde. |
Os nomes vêm de constantes
Em TypeScript, nunca digite um nome de evento à mão. Eles são constantes em @aicore8/shared:
| Constante | Eventos |
|---|---|
CORE | Os eventos de servidor e de cliente do ai-core (CORE.playerLoadedEvent, CORE.clientDeadEvent...) e as chaves de GlobalState (CORE.pvpStateKey...). |
KEY_HINTS | KEY_HINTS.changedEvent. |
MENU_EVENTS, LIB_UI | As respostas de UI do ai-lib. |
VEHICLES_EVENTS | O feed de donos do ai-vehicles. |
VRP | VRP.configEvent. |
PLAYER_BAGS, VEHICLE_BAGS, INVENTORY_STATE_KEY, APPEARANCE_STATE_KEY, dutyCountKey(job)... | Chaves de state bags. |
O Lua não tem constantes: use a string mostrada ao lado de cada evento.
Um primeiro listener
import { CORE, type CharacterInfo } from "@aicore8/shared";
on(CORE.playerLoadedEvent, (src: number, character: CharacterInfo) => {
console.log(`${character.firstname} ${character.lastname} joined as ${src}`);
});Para a vida inteira de um personagem no servidor (carregado, descarregado e os personagens já no mundo quando seu recurso reinicia), use o onCharacter({ loaded, unloaded }) da lib (aiLib.onCharacter em Lua) em vez dos dois eventos à mão. Um recurso que inicia tarde perde os eventos disparados antes de ele iniciar; o onCharacter repete esses personagens para você.
Os eventos locais do ai-core são locais de propósito. Nunca use RegisterNetEvent (ou onNet) com um dos nomes deles: isso deixaria o cliente de qualquer jogador disparar um ai-core:moneyChanged ou ai-core:playerLoaded falso no seu handler. Um AddEventHandler / on simples só ouve eventos disparados no mesmo lado.
Notificações
Como os cards de notificação do ai-lib chegam a uma UI de notificação de terceiros pelo ai-core, e o único export por trás disso.
Eventos de servidor
Cada evento local de servidor que o ai-core dispara - personagens, dinheiro, empregos, serviço, gangues, metadata, definições, itens, mortes - com argumentos e listeners em TypeScript e Lua.