AI Core
Referência da APIEventos e estado

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

TipoO que éComo escutar
Evento localDisparado 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 eventEnviado 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 bagUm 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áginaO quê
Eventos de servidorPersonagem carregado, spawnado, descarregado; dinheiro, empregos, serviço, gangues, metadata; item usado; jogador morreu; definições de empregos e gangues; inventário trocado.
Eventos de clienteO 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 eventsO 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-libRespostas de menus, caixas de entrada, prompts e da barra de progresso, para scripts que chamam os exports do ai-lib eles mesmos.
State bagsPLAYER_BAGS, VEHICLE_BAGS e cada chave de GlobalState que o ai-core escreve.
Eventos da ponte de frameworksOs 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:

ConstanteEventos
COREOs eventos de servidor e de cliente do ai-core (CORE.playerLoadedEvent, CORE.clientDeadEvent...) e as chaves de GlobalState (CORE.pvpStateKey...).
KEY_HINTSKEY_HINTS.changedEvent.
MENU_EVENTS, LIB_UIAs respostas de UI do ai-lib.
VEHICLES_EVENTSO feed de donos do ai-vehicles.
VRPVRP.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

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}`);
});

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.

Nesta página