Most vRP

ai-core uruchamia skrypty vRP przez swój wbudowany most vRP (robi provide dla vrp). Strona Lua mostu dociera do strony TypeScript ai-core przez eksporty z tej strony. Istnieją dla tego mostu: skrypt vRP używa własnego API vRP (vRP.getUData, vRP.query, vRP.hasPermission...), na które odpowiada most, a skrypt ai-* nigdy ich nie potrzebuje. Mapowanie vRP w panelu (uprawnienia, grupy, przedmioty) edytuje się w panelu administratora, nie przez te eksporty.

Są wymienione, aby dokumentacja była kompletna. Każdy odpowiada od razu albo przez callback, jak każdy eksport ai-core.

VrpGetDataCopy Anchor Link

Czyta jedną wartość z magazynu klucz-wartość vRP (to, co czytają getUData, getCData, getSData i getGData z vRP). Wartości podróżują jako tekst hex, aby każdy bajt przetrwał drogę między Lua a TypeScript.

Strona: Serwer · Czeka: nie (odpowiada przez done; od razu dla klucza w pamięci podręcznej) · Lib: brak (tylko most)

VrpGetData(kind: string, owner: string, key: string, done: (hex: string) => void): void

exports['ai-core']:VrpGetData('u', tostring(userId), 'myscript:data', function(hex) end)

ParametryCopy Anchor Link

ZwracaCopy Anchor Link

Nic. done dostaje wartość jako hex albo "", gdy klucz nie jest ustawiony lub argument jest zły. Dane wczytanych kont i postaci zostają w pamięci podręcznej, więc odpowiada od razu.

PrzykładCopy Anchor Link

Bez przykładu: skrypty vRP wywołują vRP.getUData i podobne, które most zamienia na ten eksport.

VrpSetDataCopy Anchor Link

Zapisuje jedną wartość w magazynie klucz-wartość vRP. Jest zapisywana do bazy danych (ai_core_vrp_data) w ciągu sekundy i gdy jej postać jest zwalniana.

Strona: Serwer · Czeka: nie · Lib: brak (tylko most)

VrpSetData(kind: string, owner: string, key: string, hex: string): boolean

local ok = exports['ai-core']:VrpSetData('u', tostring(userId), 'myscript:data', hex)

ParametryCopy Anchor Link

ZwracaCopy Anchor Link

boolean: true, gdy wartość została zapisana. false (z ostrzeżeniem w konsoli), gdy argument jest zły albo hex nie jest poprawnym tekstem hex.

PrzykładCopy Anchor Link

Bez przykładu: skrypty vRP wywołują vRP.setUData i podobne.

VrpQueryCopy Anchor Link

API bazy danych vRP (vRP.query, vRP.execute, vRP.scalar dla przygotowanych zapytań) na puli bazy danych ai-core. Placeholdery @name są wypełniane z tabeli parametrów; kilka zapytań w jednym tekście działa po kolei w jednej transakcji, a odpowiada ostatnie.

Strona: Serwer · Czeka: nie (odpowiada przez done) · Lib: brak (tylko most)

VrpQuery(
  sql: string,
  params: unknown,
  mode: "query" | "execute" | "scalar",
  done: (error: string | null, ...answer: unknown[]) => void,
): void

exports['ai-core']:VrpQuery('SELECT 1 AS n', {}, 'scalar', function(err, value) end)

ParametryCopy Anchor Link

ZwracaCopy Anchor Link

Nic. done dostaje, po miejscu na błąd: dla query wiersze i liczbę zmienionych wierszy; dla execute liczbę zmienionych wierszy; dla scalar pierwszą kolumnę pierwszego wiersza (lub null). Przy niepowodzeniu done dostaje tylko tekst błędu ("empty query" dla pustego sql).

PrzykładCopy Anchor Link

Bez przykładu: skrypty vRP wywołują vRP.prepare i vRP.query. Inne zasoby używają @aicore-fivem/mysql (skrypty ai-*) albo API oxmysql z ai-mysql.

GetVrpConfigCopy Anchor Link

Mapowanie vRP z panelu (data/vrp.json): które prace, gangi, stopnie i administratorzy ai-core mają które uprawnienia vRP, co znaczą nazwy grup vRP i którym przedmiotem ekwipunku jest każde id przedmiotu vRP.

Strona: Serwer · Czeka: nie · Lib: brak (tylko most)

GetVrpConfig(): VrpConfig

local config = exports['ai-core']:GetVrpConfig()

ParametryCopy Anchor Link

Brak.

ZwracaCopy Anchor Link

VrpConfig: defaults (wbudowane reguły prefiksów), permissions (reguły), groups (nazwa grupy vRP na pracę / gang / stopień / administratora) i items (id przedmiotu vRP na nazwę przedmiotu). Zobacz VrpConfig. Po zmianie w panelu ai-core wysyła serwerowe zdarzenie ai-core:vrp:config z tym samym kształtem.

PrzykładCopy Anchor Link

Bez przykładu: most czyta to, aby odpowiadać na vRP.hasPermission i vRP.hasGroup.

VrpPermissionAskedCopy Anchor Link

Zapisuje string uprawnienia, o który zapytał skrypt vRP, aby panel mógł wyświetlić każde uprawnienie używane przez skrypty serwera, a właściciel mógł je zmapować.

Strona: Serwer · Czeka: nie · Lib: brak (tylko most)

VrpPermissionAsked(permission: string): boolean

local new = exports['ai-core']:VrpPermissionAsked('police.armory')

ParametryCopy Anchor Link

ZwracaCopy Anchor Link

boolean: true, gdy uprawnienie było nowe i jest teraz zapisane. false, gdy było już znane, nie jest poprawnym tekstem albo zapisana lista jest pełna.

PrzykładCopy Anchor Link

Bez przykładu: most wywołuje to z vRP.hasPermission.