AI Core
Dokumentacja APIZdarzenia i stan

Zdarzenia i stan

Jak ai-core mówi innym skryptom, że coś się zmieniło - zdarzenia lokalne, zdarzenia sieciowe, state bagi - i jak ich nasłuchiwać w TypeScript i Lua.

ai-core mówi innym skryptom, gdy coś się zmienia: postać się wczytała, pieniądze się przesunęły, praca się zmieniła, gracz został powalony, HUD się ukrył. Twój skrypt nasłuchuje zamiast pytać w kółko. Ta sekcja wymienia każde zdarzenie i każdą wspólną wartość stanu, których używają inne zasoby.

Trzy rodzaje

RodzajCo to jestJak nasłuchiwać
Zdarzenie lokalneWysyłane po jednej stronie (serwer lub jeden klient) dla każdego zasobu po tej stronie. Nigdy nie przechodzi przez sieć. Większość zdarzeń ai-core jest lokalna.TS: on(name, handler). Lua: AddEventHandler(name, handler).
Zdarzenie siecioweWysyłane z serwera do klienta jednego gracza (lub w drugą stronę).Klient TS: onServerEvent(name, ...) z liba. Klient Lua: aiLib.onServerEvent(name, handler).
State bagWartość zapisana w GlobalState, na graczu lub na encji. Każdy może ją czytać; zapisuje ją tylko zasób, do którego należy.GlobalKey, PlayerState, EntityState, GlobalGroup z liba albo GlobalState[...], Player(src).state[...], Entity(e).state[...] w Lua.

Strony

StronaCo
Zdarzenia serwerowePostać wczytana, pojawiona, zwolniona; pieniądze, prace, służba, gangi, metadane; użyty przedmiot; śmierć gracza; definicje prac i gangów; zmiana ekwipunku.
Zdarzenia klienckieWczytanie lub zwolnienie lokalnej postaci, stan powalenia, wartości w pamięci podręcznej, widoczność HUD, synchronizacja świata, podpowiedzi klawiszy, pas bezpieczeństwa.
Zdarzenia siecioweKanał danych gracza, którego klient może nasłuchiwać, i własny ruch ai-core, którego nie wolno wywoływać.
Zdarzenia UI ai-libOdpowiedzi menu, okien wprowadzania, podpowiedzi i paska postępu, dla skryptów, które same wywołują eksporty ai-lib.
State bagiPLAYER_BAGS, VEHICLE_BAGS i każdy klucz GlobalState zapisywany przez ai-core.
Zdarzenia mostu frameworkówZdarzenia ESX, QB / Qbox i vRP, które ai-core wysyła dla skryptów napisanych dla tych frameworków, i zdarzenia frameworków, na które odpowiada.

Nazwy pochodzą ze stałych

W TypeScript nigdy nie wpisuj nazwy zdarzenia ręcznie. To stałe w @aicore8/shared:

StałaZdarzenia
CORESerwerowe i klienckie zdarzenia ai-core (CORE.playerLoadedEvent, CORE.clientDeadEvent...) i klucze GlobalState (CORE.pvpStateKey...).
KEY_HINTSKEY_HINTS.changedEvent.
MENU_EVENTS, LIB_UIOdpowiedzi UI ai-lib.
VEHICLES_EVENTSKanał właścicieli z ai-vehicles.
VRPVRP.configEvent.
PLAYER_BAGS, VEHICLE_BAGS, INVENTORY_STATE_KEY, APPEARANCE_STATE_KEY, dutyCountKey(job)...Klucze state bagów.

Lua nie ma stałych: używaj stringa pokazanego obok każdego zdarzenia.

Pierwsze nasłuchiwanie

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

Dla całego życia postaci na serwerze (wczytana, zwolniona i postacie, które są już w świecie, gdy twój zasób się restartuje) używaj onCharacter({ loaded, unloaded }) z liba (aiLib.onCharacter w Lua) zamiast ręcznie obsługiwać dwa zdarzenia. Zasób, który startuje późno, przegapia zdarzenia wysłane przed jego startem; onCharacter odtwarza te postacie za ciebie.

Lokalne zdarzenia ai-core są lokalne celowo. Nigdy nie rób RegisterNetEvent (ani onNet) dla żadnej z ich nazw: pozwoliłoby to klientowi dowolnego gracza wysłać fałszywe ai-core:moneyChanged lub ai-core:playerLoaded do twojego handlera. Zwykłe AddEventHandler / on słyszy tylko zdarzenia wysłane po tej samej stronie.

Na tej stronie