Lib: serwer
@aicore8/lib/server i serwerowa strona aiLib: czym są, jak je wczytać w TypeScript i Lua oraz każda strona tematyczna.
Lib serwerowy to zestaw funkcji pomocniczych, których każdy serwerowy skrypt ai-* używa zamiast pisać ten sam kod od nowa: bezpieczne odpowiadanie klientom, komendy, gracze, przedmioty, pojazdy, pieniądze, logi i panel administratora. Większość funkcji, które dotykają innego systemu (ekwipunek, klucze, telefon, więzienie...), przechodzi przez ai-core, więc twój skrypt działa dalej, gdy właściciel serwera wymieni skrypt ekwipunku albo telefonu.
TypeScript
Importuj z @aicore8/lib/server w plikach w resource/server/. Funkcje działające po każdej stronie (odmowy, czytniki wejścia, matematyka) pochodzą z @aicore8/lib/shared.
import { onClientCallback, inventory, notify } from "@aicore8/lib/server";
import { fail, oneArg, readId } from "@aicore8/lib/shared";Każdy zasób zrobiony z szablonu ai-core już zależy od tego pakietu ("@aicore8/lib": "workspace:*" w package.json); build pakuje go do dist/server.js.
Lua
Zasoby Lua dostają te same funkcje w globalnej tabeli aiLib z zasobu ai-lib. Dodaj dwie linie do swojego fxmanifest.lua:
dependency 'ai-lib'
shared_script '@ai-lib/init.lua'Potem wywołuj aiLib.<name> w dowolnym pliku serwera. Każdy moduł wczytuje się przy pierwszym użyciu i działa wewnątrz twojego zasobu, więc komendy i callbacki, które rejestrujesz, należą do twojego zasobu i znikają, gdy się zatrzyma.
aiLib.addCommand('hello', { help = 'Says hello' }, function(source)
aiLib.notify(source, 'Hello!', 'success')
end)Funkcje Lua oznaczone jako Czeka (progressFor, minigameFor, spawnVehicle, triggerClientCallback, billing.unpaid, appearance.get) wstrzymują kod, aż przyjdzie odpowiedź. Działają tylko wewnątrz wątku. Handlery aiLib.onClientCallback i aiLib.onClientEvent już w nim działają; w każdym innym miejscu opakuj wywołanie w CreateThread(function() ... end).
Nie każda funkcja TypeScript ma odpowiednik w Lua. Każdy wpis mówi to wprost, gdy go nie ma. Brakuje w Lua: PendingActions, PlayerMap, Cooldowns, KeyedCooldowns, SourceLock, KeyWatchers, funkcji pozycji, AreaStream, klas state bagów, AdminPanel, DataFile i funkcji bazy danych (zasoby Lua używają do SQL API oxmysql z ai-mysql).
Tematy
Wejście z klienta
onClientCallback, onClientEvent, strażnicy, triggerClientCallback, progressFor, minigameFor, PendingActions.
Komendy
addCommand: sparsowane argumenty, uprawnienia, podpowiedzi na czacie.
Gracze i postacie
online, onCharacter, notify, gracze w pobliżu, pozycje, PlayerMap, cooldowny, blokady, limity częstotliwości.
Postacie, wczytane albo nie
characters: znajdź, przeczytaj i zmień dowolną postać przez ai-core - pieniądze, prace, gangi, metadane, imię, czas gry.
Przedmioty
inventory: dawanie, zabieranie, liczenie, schowki, sklepy, przedmioty używalne.
Pojazdy
spawnVehicle, vehicleType, vehicleKeys, paliwo, garaże, encje z id sieciowych.
Pieniądze i bankowość
money.transfer, banking, billing.
Prace i służby
dispatch, prison, mdt, ems, medical, stress, needs, definicje, isPrimeTime.
Świat
Czas i pogoda, routing buckety, drzwi, zapisane postacie.
Telefon i wygląd
numery telefonów, maile, SMS-y; zapisany wygląd postaci.
State bagi
EntityState, PlayerState, GlobalKey, GlobalGroup: zapis replikowanych wartości.
Logi
aiLog, aiLogChannels: logi przez ai-core do Discorda, Fivemanage i dalej.
Strumieniowanie obszarów
AreaStream: obiekty świata wysyłane tylko graczom w ich pobliżu.
Panel administratora
AdminPanel i DataFile: ustawienia twojego skryptu w panelu ai-core.
Baza danych
createDatabaseTables, WriteQueue.
Funkcje wspólne z klientem
Wejście serwera ponownie eksportuje też funkcje /fivem, więc możesz je importować także z @aicore8/lib/server. Są opisane raz na stronie Lib: shared i fivem:
registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted, createLocale, loadLocaleTexts, LOCALE_CONVAR, ByResource, caller, onStop, plateOf, Reasons, every (z typami EveryOptions i Job), stateBoolean, stateNumber, stateString (typ StateParse).
Klasy state bagów EntityState, PlayerState, GlobalKey i GlobalGroup eksportowane z wejścia serwera to wersje serwerowe: dodają set. Zobacz State bagi.
Dwie funkcje, których używa tylko ai-core
sendPlayerData(source, key, value) i patchPlayerData(source, key, patch) wypychają jedną wartość danych gracza (AiPlayerData) do klienta tego gracza. Wywołuje je ai-core; twój skrypt nigdy ich nie potrzebuje. Dane gracza czytaj na kliencie przez getPlayerData (Lib: klient).
Członkostwo i dane gracza
hasJob, inGang, onDutyIn, allows, onMembershipChange, getPlayerData, onPlayerData i seedPlayerData - postać, pieniądze, prace, służba i gangi lokalnego gracza tak, jak wypycha je ai-core.
Wejście z klienta
Bezpieczne odpowiadanie klientom: onClientCallback, onClientEvent, strażnicy, triggerClientCallback, paski postępu i minigry sprawdzane przez serwer, PendingActions.