É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
| Sorte | Ce que c’est | Comment écouter |
|---|---|---|
| Événement local | Dé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éseau | Envoyé 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 bag | Une 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
| Page | Contenu |
|---|---|
| Événements serveur | Personnage 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 client | Le 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éseau | Le 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-lib | Ré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 bags | PLAYER_BAGS, VEHICLE_BAGS et chaque clé GlobalState qu’écrit ai-core. |
| Événements du pont de framework | Les é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 |
|---|---|
CORE | Les événements serveur et client d’ai-core (CORE.playerLoadedEvent, CORE.clientDeadEvent...) et les clés GlobalState (CORE.pvpStateKey...). |
KEY_HINTS | KEY_HINTS.changedEvent. |
MENU_EVENTS, LIB_UI | Les réponses UI d’ai-lib. |
VEHICLES_EVENTS | Le flux des propriétaires d’ai-vehicles. |
VRP | VRP.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
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é.
Notifications
Comment les cartes de notification d’ai-lib atteignent une interface de notifications tierce via ai-core, et le seul export qui est derrière.
Événements serveur
Chaque événement local côté serveur que déclenche ai-core - personnages, argent, métiers, service, gangs, métadonnées, définitions, objets, morts - avec arguments et écouteurs en TypeScript et en Lua.