QBESXStandalone
Agency-Shops Экспорты & API
Все магазины 24/7, LTD, Rob's Liquor, хозяйственные магазины, Ammu-Nation и заправки на карте в одном скрипте для FiveM.
v1.0.0Платно5 СтраницыС October 19, 2026, 20:00 CEST
01Клиентские экспорты
| Экспорт | Описание |
|---|---|
GetFuel(vehicle) | Уровень топлива транспорта от 0 до 100, в том же формате, что возвращает LegacyFuel. |
SetFuel(vehicle, level) | Устанавливает уровень топлива транспорта от 0 до 100. |
02Серверные экспорты
| Экспорт | Описание |
|---|---|
GetOwner(id) | Идентификатор и имя владельца магазина или заправки, либо nil, если владельца нет. |
AddStock(id, item, amount) | Добавляет единицы товара на склад купленного магазина вплоть до Config.Ownership.MaxStock. Возвращает true при успехе. |
AddFuelStock(id, litres) | Добавляет литры в резервуар купленной заправки вплоть до Config.GasStations.MaxFuel. Возвращает true при успехе. |
GetBalance(id) | Сумма денег в кассе купленного магазина или заправки, либо nil. |
03События
| Название | Сторона | Описание |
|---|---|---|
agency-shop:server:purchased | Сервер | Срабатывает с параметрами (source, storeId, items, total, account) после успешной покупки. items перечисляет переданные предметы, а total указывает уплаченную сумму, избавляя скрипты статистики или миссий от необходимости постоянного опроса. |
agency-shop:server:shoplift | Сервер | Срабатывает с параметрами (source, storeId, value, coords), когда игрок выходит из магазина с неоплаченными товарами в корзине или тележке. При Config.Dispatch.System = 'event' это единственное оповещение, которое может перехватить ваш собственный скрипт диспетчера. |
+Полезно знать
Agency-Shops предоставляет несколько exports и два серверных события, чтобы ваши собственные скрипты топлива, поставок, диспетчерской службы и статистики могли работать с магазинами.
- Уровень топлива
- Клиентские функции GetFuel и SetFuel работают аналогично вызовам LegacyFuel со значением уровня от 0 до 100. В скриптах под LegacyFuel достаточно изменить только имя ресурса.
- Владельцы и склад
- GetOwner и GetBalance считывают данные купленного магазина или заправки по id. AddStock и AddFuelStock добавляют штуки или литры, например, из вашего скрипта поставок или работ.
- События
- Событие agency-shop:server:purchased срабатывает после каждой покупки с данными игрока, магазина, товаров, общей суммы и счета. agency-shop:server:shoplift срабатывает, когда игрок выходит с неоплаченными товарами.
?Частые вопросы
Как узнать владельца магазина?
На стороне сервера вызовите exports['Agency-Shops']:GetOwner(id). Он возвращает identifier и имя владельца, либо nil, если у магазина нет владельца.
Как отправить собственное оповещение полиции о краже?
Установите Config.Dispatch.System = 'event' и обрабатывайте agency-shop:server:shoplift. Событие передает игрока, id магазина, стоимость товаров и координаты.