QBESXStandalone

Agency-Blackmarket V2 Экспорты & API

Живой чёрный рынок для FiveM на QBCore, Qbox, ESX или полностью в режиме standalone.

v2.0.0Платно6 Страницы

01Клиентские экспорты

Экспорт	Описание
`OpenMenu()`	Открывает меню /ablackmarket, например из радиального меню или приложения телефона. Действуют те же проверки, что и для команды.
`CloseMenu()`	Закрывает меню и возвращает управление мышью игре.
`IsMenuOpen()`	Возвращает true, пока открыто меню чёрного рынка, у дилера или где угодно.

02Серверные экспорты

Экспорт	Описание
`GetReputation(source)`	Очки репутации игрока, 0 для игрока, у которого их ещё нет.
`SetReputation(source, value)`	Устанавливает репутацию игрока на заданное значение, не ниже 0. При успехе возвращает true.
`AddReputation(source, amount)`	Добавляет репутацию или отнимает её при отрицательном значении. О новом уровне сообщается игроку и приложению Companion. При успехе возвращает true.
`GetLevel(source)`	Возвращает два значения: номер уровня игрока (по умолчанию от 1 до 5) и его название.
`AddCredit(source, amount)`	Добавляет кредит дилера, который игрок может потратить на следующую покупку или заказ. При успехе возвращает true.
`RelocateDealer(dealerId)`	Сразу перемещает дилера в другое из его мест. Возвращает true, если он переместился.
`SendDealerAway(dealerId, minutes)`	Дилер исчезает на указанное число минут, а затем появляется в другом своём месте, как после визита полиции.
`IsDealerPresent(dealerId)`	True, пока дилер стоит в одном из своих мест и не ушёл.
`StartFlashSale(minutes)`	Запускает распродажу случайных предметов со скидкой. Без минут используется время из Config.FlashSale.

03События

Название	Сторона	Описание
`agency-blackmarket:deal`	Сервер	Срабатывает на сервере с (source, kind, data) после каждой сделки. kind: buy, sell, launder, order, pickup или job, а data содержит подробности сделки, например дилера, предметы и сумму.
`agency-blackmarket:dealerMoved`	Сервер	Срабатывает на сервере с (dealerId, pos, reason), когда дилер меняет место. reason: rotate, return, admin или export.
`agency-blackmarket:flashSale`	Сервер	Срабатывает на сервере с (items, minutes), когда начинается распродажа. items сопоставляет каждому предмету со скидкой её размер в процентах.

+Полезно знать

Agency-Blackmarket V2 предлагает экспорты и события, чтобы ваши собственные скрипты могли выдавать репутацию и кредит, управлять дилерами и реагировать на сделки.

Репутация и кредит: GetReputation, SetReputation, AddReputation и GetLevel читают и меняют положение игрока, а AddCredit начисляет кредит дилера. Они принимают серверный id игрока, который находится онлайн.
Дилеры и распродажи: RelocateDealer, SendDealerAway и IsDealerPresent управляют дилерами по id из Config.Dealers, а StartFlashSale запускает распродажу из вашего собственного события.
События: agency-blackmarket:deal срабатывает после каждой сделки, agency-blackmarket:dealerMoved после каждого переезда, а agency-blackmarket:flashSale при начале распродажи. Все три срабатывают только на сервере и подходят для логов, полицейских инструментов или ваших собственных работ.

?Частые вопросы

Как открыть меню из моего радиального меню?

Вызовите exports['Agency-Blackmarket']:OpenMenu() на клиенте. Действуют те же проверки, что и для команды, включая предмет из Config.Menu.item.