Agency Docs
QBESXStandalone

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

Работа шахтёром для FiveM на QBCore, Qbox, ESX или полностью в standalone-режиме, в трёх местах: карьер Davis Quartz.

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

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

ЭкспортОписание
OpenMenu(page)Открывает меню, например из радиального меню или приложения на телефоне. page может иметь значение overview (по умолчанию), market, tools, smelter, cutting или contracts.
CloseMenu()Закрывает меню и возвращает управление мышью игре.
IsMenuOpen()True, пока меню открыто.
IsWorking()True, пока игрок добывает руду или ограняет самоцвет.
GetLevel()Уровень добычи игрока.

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

ЭкспортОписание
GetLevel(source)Уровень добычи игрока, 0, если игрок неизвестен.
GetProgress(source)Уровень и прогресс в формате { level, xp, need, pct, max }.
AddXp(source, amount)Начисляет XP, повышает уровень и показывает соответствующее сообщение. Возвращает true, если игрок найден.
SetLevel(source, level)Устанавливает уровень в диапазоне от 1 до максимального и обнуляет XP.
GetStats(source)Что игрок успел сделать: { mined, smelted, cut, broken, sold, earned, contracts }.
GetPrice(item)Текущая рыночная цена одной единицы предмета.

03События

НазваниеСторонаОписание
agency-minerjob:minedСерверВызывается на сервере после выплаты за добычу и передаёт source, item, count и область добычи. Подпишитесь с помощью AddEventHandler, например для заданий или статистики.
agency-minerjob:soldСерверВызывается на сервере после продажи и передаёт source, item, count и общую сумму выплаты.
agency-minerjob:contractСерверВызывается на сервере после сдачи контракта и передаёт source, item, count и выплату.

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

Agency-Minerjob V2 предоставляет exports и серверные события, чтобы квесты, достижения, телефоны и инструменты администратора могли получать уровни и цены, выдавать XP и реагировать на добычу, продажи и контракты.

Уровни и XP
GetLevel, GetProgress, AddXp и SetLevel считывают и изменяют уровень игрока на сервере. AddXp показывает сообщение о повышении уровня, как при добыче.
Статистика и цены
GetStats возвращает данные о том, сколько игрок добыл, переплавил, огранил, разбил, продал, заработал и доставил. GetPrice считывает текущую рыночную цену любого предмета.
Серверные события
agency-minerjob:mined, agency-minerjob:sold и agency-minerjob:contract срабатывают на сервере после выдачи вознаграждения. Используйте AddEventHandler для подписки, эти события только сообщают о произошедшем, выплата уже состоялась.

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

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

Вызовите exports['Agency-Minerjob']:OpenMenu() на клиенте или передайте страницу, например 'market' или 'contracts', чтобы открыть её напрямую.

После этой страницы всё ещё не получается? Дальше подключается наша поддержка.