Мост vRP

ai-core запускает скрипты vRP через свой встроенный мост vRP (он объявляет provide для vrp). Lua-часть моста обращается к TypeScript-части ai-core через экспорты на этой странице. Они существуют для этого моста: скрипт vRP использует собственный API vRP (vRP.getUData, vRP.query, vRP.hasPermission...), на который отвечает мост, а скрипту ai-* они никогда не нужны. Сопоставление vRP в панели (права, группы, предметы) редактируется в админ-панели, а не через эти экспорты.

Они перечислены, чтобы справочник был полным. Каждый отвечает сразу или через callback, как любой экспорт ai-core.

VrpGetDataCopy Anchor Link

Читает одно значение из хранилища ключ-значение vRP (то, что читают getUData, getCData, getSData и getGData в vRP). Значения передаются как hex-текст, чтобы любые байты пережили путь между Lua и TypeScript.

Сторона: сервер · Ожидание: нет (отвечает через done; сразу для закэшированного ключа) · Библиотека: нет (только мост)

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

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

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

Ничего. done получает значение в hex или "", когда ключ не задан или аргумент неверен. Данные загруженных аккаунтов и персонажей остаются в кэше, поэтому ответ приходит сразу.

ПримерCopy Anchor Link

Без примера: скрипты vRP вызывают vRP.getUData и подобные, которые мост превращает в этот экспорт.

VrpSetDataCopy Anchor Link

Сохраняет одно значение в хранилище ключ-значение vRP. Оно записывается в базу данных (ai_core_vrp_data) в течение секунды и при выгрузке его персонажа.

Сторона: сервер · Ожидание: нет · Библиотека: нет (только мост)

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

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

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

boolean: true, когда значение сохранено. false (с предупреждением в консоли), когда аргумент неверен или hex не является допустимым hex-текстом.

ПримерCopy Anchor Link

Без примера: скрипты vRP вызывают vRP.setUData и подобные.

VrpQueryCopy Anchor Link

API базы данных vRP (vRP.query, vRP.execute, vRP.scalar подготовленных запросов) на пуле базы данных ai-core. Плейсхолдеры @name заполняются из таблицы параметров; несколько запросов в одном тексте выполняются по порядку внутри одной транзакции, и отвечает последний.

Сторона: сервер · Ожидание: нет (отвечает через done) · Библиотека: нет (только мост)

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)

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

Ничего. done получает после позиции ошибки: для query строки и число затронутых строк; для execute число затронутых строк; для scalar первый столбец первой строки (или null). При ошибке done получает только текст ошибки ("empty query" для пустого sql).

ПримерCopy Anchor Link

Без примера: скрипты vRP вызывают vRP.prepare и vRP.query. Другие ресурсы используют @aicore-fivem/mysql (скрипты ai-*) или API oxmysql в ai-mysql.

GetVrpConfigCopy Anchor Link

Сопоставление vRP из панели (data/vrp.json): какие работы, банды, ранги и админы ai-core обладают какими правами vRP, что означают имена групп vRP и каким предметом инвентаря является каждый id предмета vRP.

Сторона: сервер · Ожидание: нет · Библиотека: нет (только мост)

GetVrpConfig(): VrpConfig

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

ПараметрыCopy Anchor Link

Нет.

ВозвращаетCopy Anchor Link

VrpConfig: defaults (встроенные правила по префиксу), permissions (правила), groups (имя группы vRP в работу / банду / ранг / админа) и items (id предмета vRP в имя предмета). См. VrpConfig. После изменения в панели ai-core отправляет серверное событие ai-core:vrp:config той же формы.

ПримерCopy Anchor Link

Без примера: мост читает его, чтобы отвечать на vRP.hasPermission и vRP.hasGroup.

VrpPermissionAskedCopy Anchor Link

Записывает строку права, которую запросил скрипт vRP, чтобы панель могла показать все права, используемые скриптами сервера, а владелец мог их сопоставить.

Сторона: сервер · Ожидание: нет · Библиотека: нет (только мост)

VrpPermissionAsked(permission: string): boolean

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

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

boolean: true, когда право было новым и теперь записано. false, когда оно уже было известно, не является допустимым текстом или список записанных заполнен.

ПримерCopy Anchor Link

Без примера: мост вызывает его из vRP.hasPermission.