AI Core
API-ReferenzEvents und Zustand

Events und Zustand

Wie ai-core anderen Skripten mitteilt, dass sich etwas geändert hat - lokale Events, Net-Events, State Bags - und wie du in TypeScript und Lua zuhörst.

ai-core teilt anderen Skripten mit, wenn sich etwas ändert: ein Charakter wurde geladen, Geld wurde bewegt, ein Job hat sich geändert, der Spieler ist zu Boden gegangen, das HUD wurde ausgeblendet. Dein Skript hört zu, statt immer wieder zu fragen. Dieser Bereich listet jedes Event und jeden gemeinsamen Zustandswert, den andere Ressourcen nutzen.

Die drei Arten

ArtWas es istWie du zuhörst
Lokales EventWird auf einer Seite (Server oder ein Client) für jede Ressource auf dieser Seite ausgelöst. Überquert nie das Netzwerk. Die meisten Events von ai-core sind lokal.TS: on(name, handler). Lua: AddEventHandler(name, handler).
Net-EventWird vom Server an den Client eines Spielers gesendet (oder umgekehrt).TS-Client: onServerEvent(name, ...) aus der Lib. Lua-Client: aiLib.onServerEvent(name, handler).
State BagEin Wert, der auf GlobalState, einem Spieler oder einer Entity gespeichert ist. Jeder kann ihn lesen; nur die besitzende Ressource schreibt ihn.GlobalKey, PlayerState, EntityState, GlobalGroup der Lib oder GlobalState[...], Player(src).state[...], Entity(e).state[...] in Lua.

Seiten

SeiteWas
Server-EventsCharakter geladen, gespawnt, entladen; Geld, Jobs, Dienst, Gangs, Metadaten; Item benutzt; Spieler gestorben; Job- und Gang-Definitionen; Inventar geändert.
Client-EventsDer lokale Charakter geladen oder entladen, Zustand am Boden, gecachte Werte, HUD-Sichtbarkeit, Welt-Sync, Tastenhinweise, Sicherheitsgurt.
Net-EventsDer Spielerdaten-Kanal, auf den ein Client hören darf, und der eigene Verkehr von ai-core, den du nicht auslösen darfst.
UI-Events von ai-libAntworten von Menüs, Eingabedialogen, Aufforderungen und dem Fortschrittsbalken, für Skripte, die die Exports von ai-lib selbst aufrufen.
State BagsPLAYER_BAGS, VEHICLE_BAGS und jeder GlobalState-Schlüssel, den ai-core schreibt.
Events der Framework-BrückeDie ESX-, QB- / Qbox- und vRP-Events, die ai-core für Skripte auslöst, die für diese Frameworks geschrieben sind, und die Framework-Events, die es beantwortet.

Namen kommen aus Konstanten

Tippe in TypeScript nie einen Eventnamen von Hand. Sie sind Konstanten in @aicore8/shared:

KonstanteEvents
COREDie Server- und Client-Events von ai-core (CORE.playerLoadedEvent, CORE.clientDeadEvent...) und GlobalState-Schlüssel (CORE.pvpStateKey...).
KEY_HINTSKEY_HINTS.changedEvent.
MENU_EVENTS, LIB_UIDie UI-Antworten von ai-lib.
VEHICLES_EVENTSDer Besitzer-Feed von ai-vehicles.
VRPVRP.configEvent.
PLAYER_BAGS, VEHICLE_BAGS, INVENTORY_STATE_KEY, APPEARANCE_STATE_KEY, dutyCountKey(job)...State-Bag-Schlüssel.

Lua hat keine Konstanten: Nutze den String, der neben jedem Event steht.

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

Für das ganze Leben eines Charakters auf dem Server (geladen, entladen und die Charaktere, die schon in der Welt sind, wenn deine Ressource neu startet) nutze onCharacter({ loaded, unloaded }) der Lib (aiLib.onCharacter in Lua), statt die beiden Events von Hand zu verwenden. Eine Ressource, die spät startet, verpasst Events, die vor ihrem Start ausgelöst wurden; onCharacter spielt diese Charaktere für dich nach.

Die lokalen Events von ai-core sind absichtlich lokal. Nutze nie RegisterNetEvent (oder onNet) für einen ihrer Namen: Damit könnte der Client jedes Spielers ein gefälschtes ai-core:moneyChanged oder ai-core:playerLoaded in deinen Handler auslösen. Ein einfaches AddEventHandler / on hört nur Events, die auf derselben Seite ausgelöst werden.

Auf dieser Seite