QBESXStandalone
Agency-Shops Eksporty & API
Każdy sklep 24/7, LTD, Rob's Liquor, sklep budowlany, Ammu-Nation i stacja paliw na mapie w jednym skrypcie dla FiveM.
v1.0.0Płatny5 StronyOd October 19, 2026, 20:00 CEST
01Eksporty klienta
| Eksport | Opis |
|---|---|
GetFuel(vehicle) | Poziom paliwa w pojeździe od 0 do 100, tak samo jak zwraca to LegacyFuel. |
SetFuel(vehicle, level) | Ustawia poziom paliwa w pojeździe, od 0 do 100. |
02Eksporty serwera
| Eksport | Opis |
|---|---|
GetOwner(id) | Identyfikator i nazwa właściciela sklepu lub stacji paliw, albo nil, gdy nikt ich nie posiada. |
AddStock(id, item, amount) | Dodaje sztuki towaru do magazynu posiadanego sklepu, maksymalnie do Config.Ownership.MaxStock. Zwraca true w przypadku powodzenia. |
AddFuelStock(id, litres) | Dodaje litry do zbiornika posiadanej stacji paliw, maksymalnie do Config.GasStations.MaxFuel. Zwraca true w przypadku powodzenia. |
GetBalance(id) | Pieniądze w kasie posiadanego sklepu lub stacji paliw, albo nil. |
03Eventy
| Nazwa | Strona | Opis |
|---|---|---|
agency-shop:server:purchased | Serwer | Wywoływane z parametrami (source, storeId, items, total, account) po zrealizowaniu zakupu. items zawiera listę wydanych przedmiotów, a total to zapłacona kwota, dzięki czemu skrypt statystyk lub misji nie musi odpytywać bazy. |
agency-shop:server:shoplift | Serwer | Wywoływane z parametrami (source, storeId, value, coords), gdy gracz opuszcza sklep z niezapłaconym towarem w koszyku lub wózku. Przy Config.Dispatch.System = 'event' jest to jedyny alert, więc Twój własny skrypt powiadomień może go przechwycić. |
+Warto wiedzieć
Agency-Shops oferuje kilka exportów i dwa eventy serwera, dzięki czemu Twoje własne skrypty paliwa, dostaw, dispatchu i statystyk mogą współpracować ze sklepami.
- Poziom paliwa
- GetFuel oraz SetFuel po stronie klienta działają tak samo jak wywołania LegacyFuel, z zakresem poziomu od 0 do 100. Skrypty przygotowane pod LegacyFuel wymagają jedynie zmiany nazwy zasobu.
- Właściciele i stan magazynu
- GetOwner i GetBalance odczytują posiadany sklep lub stację paliw po identyfikatorze id. AddStock oraz AddFuelStock dodają sztuki lub litry, na przykład z poziomu własnego skryptu dostaw lub prac.
- Eventy
- agency-shop:server:purchased wywołuje się po każdym zakupie, przekazując gracza, sklep, przedmioty, łączną kwotę oraz konto. agency-shop:server:shoplift wywołuje się, gdy gracz wychodzi z niezapłaconym towarem.
?Często zadawane pytania
Jak odczytać właściciela sklepu?
Po stronie serwera wywołaj exports['Agency-Shops']:GetOwner(id). Zwraca identyfikator oraz imię i nazwisko właściciela, lub nil gdy sklep nie ma właściciela.
Jak wysłać własne powiadomienie policji o kradzieży sklepowej?
Ustaw Config.Dispatch.System = 'event' i nasłuchuj agency-shop:server:shoplift. Otrzymasz dane gracza, id sklepu, wartość towaru oraz współrzędne.