AI Core
Referencia de la APIEventos y estado

Eventos y estado

Cómo avisa ai-core a otros scripts de que algo cambió - eventos locales, eventos de red, state bags - y cómo escucharlos en TypeScript y Lua.

ai-core avisa a otros scripts cuando algo cambia: se cargó un personaje, se movió dinero, cambió un trabajo, el jugador cayó, se ocultó el HUD. Tu script escucha en lugar de preguntar una y otra vez. Esta sección lista cada evento y cada valor de estado compartido que usan otros recursos.

Los tres tipos

TipoQué esCómo se escucha
Evento localSe dispara en un lado (el servidor o un cliente) para todos los recursos de ese lado. Nunca cruza la red. La mayoría de los eventos de ai-core son locales.TS: on(name, handler). Lua: AddEventHandler(name, handler).
Evento de redSe envía del servidor al cliente de un jugador (o al revés).Cliente TS: onServerEvent(name, ...) de la lib. Cliente Lua: aiLib.onServerEvent(name, handler).
State bagUn valor guardado en GlobalState, en un jugador o en una entidad. Todo el mundo puede leerlo; solo lo escribe el recurso dueño.GlobalKey, PlayerState, EntityState, GlobalGroup de la lib, o GlobalState[...], Player(src).state[...], Entity(e).state[...] en Lua.

Páginas

PáginaQué
Eventos de servidorPersonaje cargado, aparecido, descargado; dinero, trabajos, servicio, bandas, metadatos; objeto usado; jugador muerto; definiciones de trabajos y bandas; cambio de inventario.
Eventos de clienteEl personaje local cargado o descargado, el estado de caído, valores en caché, la visibilidad del HUD, la sincronización del mundo, ayudas de teclas, cinturón.
Eventos de redEl canal de datos del jugador que puede escuchar un cliente, y el tráfico propio de ai-core que no debes disparar.
Eventos de la interfaz de ai-libRespuestas de menús, diálogos de entrada, avisos y la barra de progreso, para scripts que llaman ellos mismos a los exports de ai-lib.
State bagsPLAYER_BAGS, VEHICLE_BAGS y cada clave de GlobalState que escribe ai-core.
Eventos del puente de frameworksLos eventos de ESX, QB / Qbox y vRP que dispara ai-core para scripts escritos para esos frameworks, y los eventos de framework a los que responde.

Los nombres vienen de constantes

En TypeScript, nunca escribas a mano el nombre de un evento. Son constantes de @aicore8/shared:

ConstanteEventos
CORELos eventos de servidor y de cliente de ai-core (CORE.playerLoadedEvent, CORE.clientDeadEvent...) y las claves de GlobalState (CORE.pvpStateKey...).
KEY_HINTSKEY_HINTS.changedEvent.
MENU_EVENTS, LIB_UILas respuestas de la interfaz de ai-lib.
VEHICLES_EVENTSEl canal de dueños de ai-vehicles.
VRPVRP.configEvent.
PLAYER_BAGS, VEHICLE_BAGS, INVENTORY_STATE_KEY, APPEARANCE_STATE_KEY, dutyCountKey(job)...Claves de state bags.

Lua no tiene constantes: usa la cadena que aparece junto a cada evento.

Un primer 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 toda la vida de un personaje en el servidor (cargado, descargado, y los personajes que ya están en el mundo cuando tu recurso se reinicia), usa el onCharacter({ loaded, unloaded }) de la lib (aiLib.onCharacter en Lua) en lugar de los dos eventos a mano. Un recurso que se inicia tarde se pierde los eventos disparados antes de que se iniciara; onCharacter vuelve a pasarte esos personajes.

Los eventos locales de ai-core son locales a propósito. Nunca hagas RegisterNetEvent (ni onNet) con uno de sus nombres: eso permitiría al cliente de cualquier jugador disparar un ai-core:moneyChanged o ai-core:playerLoaded falso dentro de tu handler. Un AddEventHandler / on normal solo oye los eventos disparados en el mismo lado.

En esta página