QBESXStandalone
Agency-Repairkit V2 Экспорты & API
Реалистичные повреждения автомобиля и четыре ремкомплекта для FiveM, на QBCore, QBox, ESX или полностью standalone.
v2.0.0Платно5 Страницы
01Клиентские экспорты
| Экспорт | Описание |
|---|---|
IsRepairing() | Возвращает true, пока локальный игрок занят ремонтом транспортного средства, например, чтобы держать закрытым своё собственное меню. |
GetVehicleCondition(vehicle) | Двигатель, кузов и бак в %, шины, грязь, уровень повреждения и протекает ли бак. Без аргумента считывает транспортное средство, в котором сидит игрок. |
OpenMenu() | Открывает меню /arepairkit, например из приложения на телефоне или из радиального меню. |
CloseMenu() | Закрывает меню и возвращает управление мышью игре. |
IsMenuOpen() | Возвращает true, пока меню открыто. |
02Серверные экспорты
| Экспорт | Описание |
|---|---|
UseKit(source, kit) | Запускает набор для игрока так, будто предмет был использован, со всеми проверками. Возвращает true, либо false и причину. Для собственных инвентарей и магазинов. |
GiveKit(source, kit, amount) | Добавляет наборы в инвентарь игрока через определённый инвентарь. Возвращает true при успехе. |
IsRepairing(source) | True, пока этот игрок занят ремонтом транспортного средства. |
GetKits() | Каждый настроенный набор с его предметом, названием, типом работы и длительностью. |
useKit(event, item, inventory, slot, data) | Экспорт предмета для ox_inventory. Записи предметов в install/ox_inventory.lua ссылаются на него, вызывать его напрямую не предполагается. |
03События
| Название | Сторона | Описание |
|---|---|---|
agency-repairkit:repaired | Сервер | Срабатывает на сервере с (source, netId, kit) после завершения ремонта и использования набора. Подходит для логов, оплаты или прогресса по работе. |
agency-repairkit:client:repaired | Клиент | Срабатывает на клиенте ремонтирующего игрока с (netId, kit), когда ремонт завершён. |
agency-repairkit:client:damageLevel | Клиент | Срабатывает на клиенте водителя с (level, vehicle) при каждом изменении уровня повреждения: ok, light, medium, heavy или critical. |
+Полезно знать
Другие ресурсы могут запускать наборы, выдавать их, проверять, работает ли игрок в данный момент, и считывать состояние транспорта. Три события сообщают о завершённых ремонтах и изменениях уровня повреждений.
- Запуск наборов из своего кода
- UseKit(source, kit) выполняет те же проверки, что и предмет инвентаря: дистанция, профессия, кулдаун и сам предмет. Это способ подключить кастомный инвентарь или NPC-продавца.
- Реакция на ремонты
- agency-repairkit:repaired срабатывает на сервере после того, как набор был израсходован, и передаёт игрока, сетевой ID транспорта и набор, например, чтобы заплатить механику или записать это в лог.
?Частые вопросы
Может ли мой HUD показывать уровень повреждений?
Да. Слушай agency-repairkit:client:damageLevel на клиенте, или в любой момент вызывай GetVehicleCondition для получения данных о двигателе, кузове, баке, шинах и уровне.