Lib: shared i fivem
@aicore8/lib/shared i /fivem: funkcje pomocnicze działające po obu stronach, do czego służy każde wejście i każda strona tematyczna.
Dwie części liba działają tak samo na kliencie i na serwerze:
| Wejście | Co zawiera | Gdzie możesz go użyć |
|---|---|---|
@aicore8/lib/shared | Zwykłe funkcje pomocnicze, które nigdy nie wywołują natywki FiveM: odmowy, czytniki wejścia, formatowanie liczb i tekstu, matematyka wektorów, geometria stref, czytniki danych panelu, teksty językowe strony NUI. | Klient, serwer, resource/common/ i kod NUI (React). |
@aicore8/lib/fivem | Funkcje pomocnicze wywołujące natywki dostępne po obu stronach: eksporty między zasobami, harmonogram, obsługa zatrzymania zasobu, loader plików językowych. | Klient, serwer i resource/common/. Nie w kodzie NUI. |
Wejścia klienta i serwera ponownie eksportują wszystko z /fivem, więc w pliku klienta lub serwera możesz importować te funkcje także z @aicore8/lib/client albo @aicore8/lib/server. Używaj /fivem tylko w plikach resource/common/, które budują obie strony.
import { fail, readInt, groupDigits } from "@aicore8/lib/shared";
import { resourceExport, every, createLocale } from "@aicore8/lib/fivem";Lua
Tylko kilka z tych funkcji ma odpowiednik w Lua w aiLib (wczytaj go przez shared_script '@ai-lib/init.lua', zobacz Lib dla Lua): every, waitFor, formatText, locale, fail, numbers.round, numbers.groupDigits, numbers.headingTo i stripGameText. Każdy wpis pokazuje wywołanie Lua, gdy istnieje, i mówi to wprost, gdy go nie ma. Do reszty Lua ma własne narzędzia: matematykę wektorów (#(a - b) dla odległości), Entity(e).state dla state bagów, exports['name']:Fn() dla eksportów.
Tematy
Eksporty między zasobami
registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted.
Harmonogram i cykl życia
every, onStop, caller, ByResource, Reasons, sleep, waitFor.
State bagi
EntityState, PlayerState, GlobalKey, GlobalGroup i ich parsery: odczyt replikowanych wartości z pamięci.
Akcje i wejście z klienta
ActionResult, fail, isActionOk, replyError, readInt, readText, readId, readVec3, oneArg, asArgs.
Tekst i liczby
formatText, round, groupDigits, formatWeight, stripGameText, randomInt, pickRandom, rollChance, ServerClock.
Pozycje
distance, flatDistance, headingTo, nearestOf, gridCell, cellKey.
Pojazdy
plateOf, normalizePlate, vehicleTypeOfClass, toVehicleProps, toVehicleSetup.
Dane panelu
num, int, bool, str, record, vec4, spec, readRecords, RecordObjects, withoutSchemaKey.
Dostęp, blipy i NPC miejsc
readAccess, ACCESS_FIELDS, decideAccess, readBlipStyle, readPlacePed i ich pola panelu.
Tłumaczenia
createLocale, loadLocaleTexts, LangTexts: pliki językowe twojego zasobu w grze i w NUI.
Logowanie
createLogger, logSafe, previewJson.
Geometria stref
ZoneShape, zoneContains, zoneBounds, polyFromCorners, readZoneShape.
Wspólne typy (Vec3, Vec4, ActionResult, AccessRule, BlipStyle, ZoneShape, VehicleProps...) są objaśnione pole po polu na stronie Wspólne typy.
Baza danych
createDatabaseTables instaluje twój sql/main.sql przy starcie; WriteQueue wykonuje zapisy do bazy danych jeden po drugim.
Eksporty między zasobami
registerExport, resourceExport, optionalExport, callExport, provideExport i isResourceStarted: udostępnianie i wywoływanie eksportów z TypeScript.