Agency-Blackmarket: Projektowanie szarej strefy bez psucia serwera

Dlaczego większość skryptów na czarny rynek zawodzi

Źle zaprojektowany skrypt czarnego rynku to najszybszy sposób na zniszczenie gospodarki serwera. Zbyt tanio i każdy staje się przestępcą. Zbyt drogo i nikt z niego nie korzysta. Zbyt bezpiecznie i nie ma ryzyka. Zbyt ryzykownie i gracze się wypalają. Agency-Blackmarket został zaprojektowany z myślą o balansie ekonomii jako priorytecie, a lista funkcji była na drugim miejscu.

Dynamiczne ceny zależne od popytu

Ceny każdego przedmiotu zmieniają się w zależności od tego, ilu graczy kupiło go w ostatnim czasie. Popyt i podaż działają automatycznie: jeśli cały serwer kupuje AR-15, cena podwaja się w ciągu kilku godzin. Gdy popyt spada, ceny powoli wracają do normy. Tworzy to naturalną dynamikę rynku zamiast sztywnych list zakupów.

Strona ryzyka

Każda wizyta na czarnym rynku ma konfigurowalną szansę na wywołanie zgłoszenia na policję, zasadzki lub starcia z rywalizującym NPC. Ryzyko rośnie wraz z wielkością zakupów. Sprytni gracze uczą się dzielić duże zakupy na kilka wizyt. Mniej ostrożni gracze wpadają i tracą swój schowek. To właśnie napięcie, które utrzymuje nielegalne RP na ciekawym poziomie.

Narzędzia admina

Każda transakcja jest rejestrowana z ID gracza, przedmiotem, ceną i znacznikiem czasu. Administratorzy widzą szarą strefę serwera na pierwszy rzut oka, mogą ustalać ceny minimalne lub tymczasowo wyłączać określone przedmioty. To narzędzie sprawia, że profesjonalne społeczności RP ufają nam w kwestii kluczowych skryptów ekonomii, nie sprzedajemy po prostu funkcji, dostarczamy warstwę zarządzania, która pozwala im działać na dużą skalę.

Integracja z Twoimi pracami

Agency-Blackmarket udostępnia eventy, których mogą nasłuchiwać Agency-Minerjob, Agency-Admin i Twoje skrypty policyjne. Ekosystem się uzupełnia, każdy pojedynczy skrypt jest przydatny osobno, ale razem tworzą one spójne, dynamiczne zachowania systemowe, których nie dałoby się napisać ręcznie.

Instalacja & konfiguracja

Agency-Blackmarket wymaga oxmysql do logowania transakcji i zapisywania dynamicznych cen. Zaimportuj blackmarket.sql, przenieś folder zasobu i dodaj ensure agency-blackmarket do server.cfg. Współrzędne lokalizacji są zdefiniowane w config.lua, resource zawiera sześć domyślnych koordynatów czarnego rynku na domyślnej mapie GTA V, które można zastąpić własnymi pozycjami MLO.

Przedmioty dostępne w sprzedaży muszą istnieć w rejestrze przedmiotów twojego frameworka. Config zawiera domyślną listę przedmiotów; dodawanie lub usuwanie przedmiotów to prosta edycja tabeli w pliku config.

Opcje konfiguracji

Ten config.lua daje pełną kontrolę nad ustawieniami ekonomii i ryzyka:

• Katalog przedmiotów, zdefiniuj każdy przedmiot, jego cenę bazową, minimalną cenę dolną, maksymalny pułap cenowy oraz współczynnik elastyczności popytu.
• Okno popytu, ile godzin historii zakupów algorytm wyceny bierze pod uwagę wstecz. Domyślnie: 6 godzin.
• Zdarzenia ryzyka, skonfiguruj szansę na wezwanie policji, szansę na zasadzkę oraz szansę na spawn wrogich NPC dla poszczególnych progów kwoty zakupu.
• Rotacja lokalizacji, lokalizacje czarnego rynku mogą rotować według harmonogramu, zmuszając graczy do korzystania z sieci informacji w świecie gry w celu znalezienia aktualnego miejsca.
• Nadpisanie ceny przez admina, starsi administratorzy mogą ręcznie ustalać tymczasowe ceny minimalne lub maksymalne dla przedmiotów podczas wydarzeń ekonomicznych.
• Przechowywanie dziennika transakcji, ile dni historii zakupów jest przechowywanych. Domyślnie: 30 dni.

Kompatybilność z frameworkami

Adaptery dla QBCore i ESX są dołączone do pakietu. W przypadku standalone zaimplementuj cztery funkcje w configu: dodawanie przedmiotów, pobieranie gotówki, wywoływanie powiadomień policji oraz opcjonalne ograniczenie dostępu na podstawie pracy. Silnik cenowy, system zdarzeń ryzyka, zarządzanie lokalizacjami i narzędzia administracyjne są w pełni niezależne od frameworka.

Dlaczego ma to znaczenie dla roleplay

Nielegalna gospodarka, która funkcjonuje zbyt bezpiecznie, zamienia się w rutynowe zakupy. System ryzyka w Agency-Blackmarket został zaprojektowany specjalnie po to, aby każdy większy zakup był decyzją, a nie zwykłą transakcją. Gracz, który spędza dziesięć minut na planowaniu dużego zakupu broni, sprawdzaniu lokacji, wyliczaniu czasu podejścia i decydowaniu, czy zabrać wsparcie, ma znacznie lepszy RP niż gracz, który po prostu otwiera menu i klika kup.

Dynamiczne ceny tworzą naturalny deficyt bez interwencji administratora. Gdy cały serwer szykuje się do zaplanowanego konfliktu, skok cen broni sygnalizuje to każdemu graczowi sprawdzającemu rynek. Sprytne postacie przestępcze uczą się kupować, zanim popyt gwałtownie wzrośnie. To zachowanie gospodarki emergentnej, które dodaje warstwę głębi strategicznej, jakiej oskryptowane menu ze stałymi cenami nigdy nie zaoferują.

Panel transakcji dla administratorów to podstawa odpowiedzialnego zarządzania gospodarką RP. Gdy nielegalna ekonomia serwera jest nieprzejrzysta, administratorzy nie są w stanie ocenić balansu, dopóki gracze nie zaczną narzekać. Dzięki pełnej widoczności transakcji możesz w czasie rzeczywistym sprawdzić, czy dany gracz lub grupa nie kupuje nieproporcjonalnie dużo, i zainterweniować, zanim zachwianie równowagi zniszczy przestępczy ekosystem serwera.

Często zadawane pytania

Czy mogę udostępnić określone przedmioty tylko wybranym organizacjom przestępczym?

Tak. Każdy przedmiot w katalogu obsługuje opcjonalny requiredFlag pole. Gracze z ustawioną tą flagą (zarządzaną przez Agency-Admin lub Twój własny system) mogą widzieć i kupować ten przedmiot; pozostali widzą go wyszarzonego z etykietą "restricted". Tworzy to wielopoziomowy czarny rynek, na którym wyższe role przestępcze mają dostęp do lepszego asortymentu.

Jak działa event zasadzki?

Gdy aktywuje się zasadzka, grupa wrogich NPC spawnuje się w lokalizacji czarnego rynku i natychmiast atakuje gracza. Liczba NPC i ich ekwipunek skalują się wraz z kwotą zakupu, która wywołała wydarzenie. Gracze, którzy przeżyją zasadzkę, zachowują zakupione przedmioty; ci, którzy zginą, tracą je na rzecz systemu łupów. Jest to celowo surowe: ryzyko musi być prawdziwe.

Czy dane o cenach można wyeksportować do analizy zewnętrznej?

Log transakcji w oxmysql można odpytywać bezpośrednio. Udostępniamy również export po stronie serwera exports['agency-blackmarket']:GetPriceHistory(item, hours) który zwraca tabelę migawek cen. Połącz to z dowolnym zewnętrznym narzędziem dashboardu, jeśli chcesz uzyskać wizualne wykresy nielegalnej gospodarki swojego serwera w czasie.

Jak uniemożliwić jednemu graczowi manipulowanie systemem popytu w celu zmiany cen?

Ustaw Config.PerPlayerDemandCap = true i Config.MaxPlayerDemandWeight = 0.3. Ogranicza to wpływ historii zakupów pojedynczego gracza na cenę globalną. Manipulowanie popytem przez jednego kupującego nadal działa, ale wymaga stałej koordynacji wielu graczy, aby znacząco zmienić ceny.

Wymagania

• Serwer FiveM (QBCore, ESX lub standalone)
• oxmysql
• konto cfx.re z ważną licencją Agency-Blackmarket
• Opcjonalnie: Agency-Admin (dla zintegrowanego panelu monitorowania transakcji)

Sezonowe wydarzenia ekonomiczne przez panel kontroli cen administratora

Narzędzia cenowe dla administratorów w Agency-Blackmarket otwierają drogę do projektowania ekonomii sterowanej wydarzeniami. Kilka sprawdzonych schematów:

Wydarzenie wyścig zbrojeń: Obniż ceny broni o 30% na 48 godzin i ogłoś to w grze (IC) za pośrednictwem wiadomości NPC. Tworzy to krótkie okno zwiększonej aktywności przestępczej, na którą policja może się przygotować. Okno zamyka się, zanim gospodarka ulegnie destabilizacji.

Szok podażowy: Tymczasowo wyłącz kategorię przedmiotów (brak materiałów wybuchowych przez tydzień). Niedobór wywołuje chomikowanie, handel na czarnym rynku między graczami oraz RP wokół braków towaru. Przywróć dostępność i obserwuj, jak rynek wraca do normy.

Wprowadzenie nowej kontrabandy: Wprowadź nowy przedmiot w wysokiej cenie z wolnym spadkiem popytu. Pierwsi nabywcy płacą więcej, a gdy inni gracze go odkryją, popyt rośnie i ceny gwałtownie skaczą przed normalizacją. Historia cen pokazuje, jak Twoja społeczność przyjęła nowy przedmiot.

Te wydarzenia ekonomiczne nie wymagają pisania własnej logiki skryptowej, są to zmiany w konfiguracji administratora. Właśnie o tę dostępność chodzi: administratorzy serwera, którzy nie są programistami, mogą organizować ciekawe wydarzenia ekonomiczne, korzystając wyłącznie z panelu administracyjnego Agency-Blackmarket.