QBESXStandalone

Agency-Blackmarket V2 Eksporty & API

Żyjący czarny rynek dla FiveM na QBCore, Qbox, ESX lub w pełni standalone.

v2.0.0Płatny6 Strony

01Eksporty klienta

Eksport	Opis
`OpenMenu()`	Otwiera menu /ablackmarket, na przykład z menu kołowego lub aplikacji w telefonie. Obowiązują te same sprawdzenia, co dla komendy.
`CloseMenu()`	Zamyka menu i oddaje mysz do gry.
`IsMenuOpen()`	Zwraca true, gdy otwarte jest menu czarnego rynku, u handlarza lub gdziekolwiek indziej.

02Eksporty serwera

Eksport	Opis
`GetReputation(source)`	Punkty reputacji gracza, 0 dla gracza, który jeszcze żadnych nie ma.
`SetReputation(source, value)`	Ustawia reputację gracza na stałą wartość, nigdy poniżej 0. Zwraca true w przypadku powodzenia.
`AddReputation(source, amount)`	Dodaje reputację lub odbiera ją przy wartości ujemnej. Nowy poziom jest ogłaszany graczowi oraz w aplikacji Companion. Zwraca true w przypadku powodzenia.
`GetLevel(source)`	Zwraca dwie wartości: numer poziomu gracza (domyślnie od 1 do 5) oraz jego nazwę.
`AddCredit(source, amount)`	Dodaje kredyt u dealera, który gracz może wydać przy następnym zakupie lub zamówieniu. Zwraca true w przypadku powodzenia.
`RelocateDealer(dealerId)`	Natychmiast przenosi dealera w inne z jego miejsc. Zwraca true, gdy dealer się przemieści.
`SendDealerAway(dealerId, minutes)`	Diler znika na określoną liczbę minut, a następnie pojawia się w innym ze swoich miejsc, tak jak po wizycie policji.
`IsDealerPresent(dealerId)`	Wartość true, gdy dealer stoi na jednym ze swoich miejsc i nie jest oddalony.
`StartFlashSale(minutes)`	Uruchamia flash sale z losowymi przedmiotami ze zniżką. Bez podania minut używany jest czas z Config.FlashSale.

03Eventy

Nazwa	Strona	Opis
`agency-blackmarket:deal`	Serwer	Wywoływane na serwerze z parametrami (source, kind, data) po każdej transakcji. kind to buy, sell, launder, order, pickup lub job, a data zawiera szczegóły transakcji, takie jak diler, przedmioty i suma.
`agency-blackmarket:dealerMoved`	Serwer	Wywoływane na serwerze z parametrami (dealerId, pos, reason), gdy diler zmienia swoją lokalizację. reason to rotate, return, admin lub export.
`agency-blackmarket:flashSale`	Serwer	Wywoływane na serwerze z parametrami (items, minutes), gdy rozpoczyna się wyprzedaż błyskawiczna. items mapuje każdy przeceniony przedmiot na jego zniżkę w procentach.

+Warto wiedzieć

Agency-Blackmarket V2 oferuje exporty i eventy, dzięki czemu Twoje własne skrypty mogą przyznawać reputację i kredyt, kontrolować dilerów i reagować na transakcje.

Reputacja i kredyt: GetReputation, SetReputation, AddReputation i GetLevel odczytują i zmieniają reputację gracza, a AddCredit przyznaje kredyt u dealera. Przyjmują identyfikator serwera gracza, który jest online.
Dilerzy i błyskawiczne wyprzedaże: RelocateDealer, SendDealerAway i IsDealerPresent kontrolują dilerów o id z Config.Dealers, a StartFlashSale uruchamia wyprzedaż z Twojego własnego eventu.
Eventy: agency-blackmarket:deal wywołuje się po każdej transakcji, agency-blackmarket:dealerMoved po każdej zmianie lokalizacji, a agency-blackmarket:flashSale przy starcie wyprzedaży. Wszystkie trzy uruchamiają się wyłącznie po stronie serwera i mogą być używane do logów, narzędzi policyjnych lub Twoich własnych prac.

?Często zadawane pytania

Jak otworzyć menu z mojego radial menu?

Wywołaj exports['Agency-Blackmarket']:OpenMenu() po stronie klienta. Obowiązują te same kontrole co w przypadku komendy, w tym przedmiot z Config.Menu.item.