Agency Docs
QBESXStandalone

Agency-Minerjob V2 Eksporty & API

Praca górnika dla FiveM na QBCore, Qbox, ESX lub w pełni standalone, w trzech lokalizacjach: kamieniołomie Davis.

v2.0.0Płatny5 Strony

01Eksporty klienta

EksportOpis
OpenMenu(page)Otwiera menu, na przykład z menu kołowego lub aplikacji w telefonie. page to overview (domyślnie), market, tools, smelter, cutting lub contracts.
CloseMenu()Zamyka menu i oddaje mysz do gry.
IsMenuOpen()Wartość true, gdy menu jest otwarte.
IsWorking()Wartość true, gdy gracz wydobywa surowce lub szlifuje klejnot.
GetLevel()Poziom górnictwa gracza.

02Eksporty serwera

EksportOpis
GetLevel(source)Poziom górnictwa gracza, 0 gdy gracz jest nieznany.
GetProgress(source)Poziom i postęp jako { level, xp, need, pct, max }.
AddXp(source, amount)Dodaje XP wraz z awansami na kolejny poziom i odpowiednim komunikatem. Zwraca true, gdy gracz został znaleziony.
SetLevel(source, level)Ustawia poziom między 1 a najwyższym poziomem i rozpoczyna go od 0 XP.
GetStats(source)Co gracz zrobił do tej pory: { mined, smelted, cut, broken, sold, earned, contracts }.
GetPrice(item)Aktualna cena rynkowa przedmiotu za sztukę.

03Eventy

NazwaStronaOpis
agency-minerjob:minedSerwerWywoływane na serwerze po wypłacie za wydobycie, z parametrami source, item, count i obszarem wydobycia. Nasłuchuj za pomocą AddEventHandler, na przykład na potrzeby zadań lub statystyk.
agency-minerjob:soldSerwerWywoływane na serwerze po sprzedaży, z parametrami source, item, count oraz łączną wypłaconą kwotą.
agency-minerjob:contractSerwerWywoływane na serwerze po dostarczeniu kontraktu, z parametrami source, item, count i wynagrodzeniem.

+Warto wiedzieć

Agency-Minerjob V2 oferuje exporty i eventy serwerowe, dzięki czemu questy, osiągnięcia, telefony i narzędzia administratorskie mogą odczytywać poziomy i ceny, przyznawać XP oraz reagować na wydobycie, sprzedaż i kontrakty.

Poziomy i XP
GetLevel, GetProgress, AddXp i SetLevel odczytują i zmieniają poziom gracza na serwerze. AddXp wyświetla komunikat o awansie na wyższy poziom, tak jak w górnictwie.
Statystyki i ceny
GetStats zwraca to, co gracz wydobył, przetopił, ściął, rozbił, sprzedał, zarobił i dostarczył. GetPrice odczytuje aktualną cenę rynkową dowolnego przedmiotu.
Eventy serwera
agency-minerjob:mined, agency-minerjob:sold oraz agency-minerjob:contract są wywoływane na serwerze po wypłaceniu nagrody. Nasłuchuj ich za pomocą AddEventHandler; one jedynie raportują, wypłata już nastąpiła.

?Często zadawane pytania

Jak otworzyć menu z mojego radial menu?

Wywołaj exports['Agency-Minerjob']:OpenMenu() po stronie klienta lub przekaż stronę, na przykład 'market' lub 'contracts', aby otworzyć ją bezpośrednio.

Nadal nie idzie po tej stronie? Nasze wsparcie przejmuje sprawę.