AI Core
Référence de l’APIÉvénements et état

Événements et état

Comment ai-core signale aux autres scripts qu’une chose a changé - événements locaux, événements réseau, state bags - et comment les écouter en TypeScript et en Lua.

ai-core prévient les autres scripts quand quelque chose change : un personnage chargé, de l’argent déplacé, un métier modifié, le joueur à terre, le HUD masqué. Votre script écoute au lieu de redemander sans cesse. Cette section liste chaque événement et chaque valeur d’état partagée qu’utilisent les autres ressources.

Les trois sortes

SorteCe que c’estComment écouter
Événement localDéclenché d’un côté (le serveur ou un client) pour chaque ressource de ce côté. Ne traverse jamais le réseau. La plupart des événements d’ai-core sont locaux.TS : on(name, handler). Lua : AddEventHandler(name, handler).
Événement réseauEnvoyé du serveur au client d’un joueur (ou dans l’autre sens).Client TS : onServerEvent(name, ...) de la lib. Client Lua : aiLib.onServerEvent(name, handler).
State bagUne valeur stockée sur GlobalState, un joueur ou une entité. Tout le monde peut la lire ; seule la ressource propriétaire l’écrit.GlobalKey, PlayerState, EntityState, GlobalGroup de la lib, ou GlobalState[...], Player(src).state[...], Entity(e).state[...] en Lua.

Pages

PageContenu
Événements serveurPersonnage chargé, apparu, déchargé ; argent, métiers, service, gangs, métadonnées ; objet utilisé ; joueur mort ; définitions des métiers et des gangs ; inventaire modifié.
Événements clientLe personnage local chargé ou déchargé, état à terre, valeurs en cache, visibilité du HUD, synchro du monde, aides de touches, ceinture de sécurité.
Événements réseauLe canal des données du joueur qu’un client peut écouter, et le trafic propre d’ai-core que vous ne devez pas déclencher.
Événements UI d’ai-libRéponses des menus, boîtes de saisie, invites et de la barre de progression, pour les scripts qui appellent eux-mêmes les exports d’ai-lib.
State bagsPLAYER_BAGS, VEHICLE_BAGS et chaque clé GlobalState qu’écrit ai-core.
Événements du pont de frameworkLes événements ESX, QB / Qbox et vRP que déclenche ai-core pour les scripts écrits pour ces frameworks, et les événements de framework auxquels il répond.

Les noms viennent de constantes

En TypeScript, ne tapez jamais un nom d’événement à la main. Ce sont des constantes de @aicore8/shared :

ConstanteÉvénements
CORELes événements serveur et client d’ai-core (CORE.playerLoadedEvent, CORE.clientDeadEvent...) et les clés GlobalState (CORE.pvpStateKey...).
KEY_HINTSKEY_HINTS.changedEvent.
MENU_EVENTS, LIB_UILes réponses UI d’ai-lib.
VEHICLES_EVENTSLe flux des propriétaires d’ai-vehicles.
VRPVRP.configEvent.
PLAYER_BAGS, VEHICLE_BAGS, INVENTORY_STATE_KEY, APPEARANCE_STATE_KEY, dutyCountKey(job)...Clés de state bag.

Lua n’a pas de constantes : utilisez la chaîne indiquée à côté de chaque événement.

Un premier écouteur

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

Pour toute la vie d’un personnage sur le serveur (chargé, déchargé, et les personnages déjà dans le monde quand votre ressource redémarre), utilisez onCharacter({ loaded, unloaded }) de la lib (aiLib.onCharacter en Lua) au lieu des deux événements à la main. Une ressource qui démarre tard manque les événements déclenchés avant son démarrage ; onCharacter rejoue ces personnages pour vous.

Les événements locaux d’ai-core sont locaux à dessein. N’utilisez jamais RegisterNetEvent (ou onNet) sur l’un de leurs noms : cela laisserait le client de n’importe quel joueur envoyer un faux ai-core:moneyChanged ou ai-core:playerLoaded dans votre handler. Un simple AddEventHandler / on n’entend que les événements déclenchés du même côté.

Sur cette page