Agency-Vending: Automaty, które naprawdę sprzedają przedmioty w twojej gospodarce

Najbardziej niedoceniany prop w GTA V

GTA V jest pełne automatów z przekąskami, które na domyślnych serwerach FiveM pełnią wyłącznie funkcję dekoracyjną. Agency-Vending sprawia, że każdy z nich staje się funkcjonalny: gracze podchodzą, wchodzą w interakcję, kupują jedzenie lub napoje w rozsądnych cenach i otrzymują odpowiednie buffy. Proste, powszechne i sprawia, że mapa tętni życiem w sposób, jakiego nie zapewnia wersja vanilla.

Towar, który się kończy

Każda maszyna ma indywidualny stan magazynowy, który zmniejsza się, gdy gracze kupują przedmioty. Puste automaty wyświetlają stan "brak towaru", dopóki nie zostaną uzupełnione. To wydaje się drobiazgiem, ale tworzy nową rolę zawodową: operatora automatów. Gracze uzupełniający maszyny otrzymują część zysków ze sprzedaży ich zapasów. Nagle każdy prop zyskuje aktywność ekonomiczną.

Różnorodność przedmiotów w zależności od typu automatu

Automaty z napojami sprzedają napoje lekko gaszące pragnienie. Automaty z przekąskami sprzedają jedzenie zaspokajające głód. Kioski z kawą sprzedają gorące napoje usuwające zmęczenie. Agency-Vending automatycznie rozpoznaje typ automatu na podstawie modelu propa i odpowiednio go zaopatruje. Zero konfiguracji dla standardowych lokalizacji.

Sygnały cenowe

Ceny są celowo niższe niż jedzenie w restauracji, ale wyższe niż gotowanie w domu. Tworzy to rozsądną hierarchię ekonomiczną: dom > automaty > fast food > restauracje. Gracze naturalnie wybierają opcję odpowiadającą ich sytuacji, co dokładnie odzwierciedla realne zachowania zakupowe.

Zgłoszenia dla adminów

Administratorzy serwera otrzymują cotygodniowe podsumowanie aktywności automatów: które maszyny zarabiają najwięcej, które są słabo uzupełniane, a w których dzielnicach brakuje towaru. Te dane to złoto do balansowania mapy i odkrywania nowych możliwości rozgrywki bez męczenia graczy ankietami.

Instalacja & konfiguracja

Agency-Vending wymaga oxmysql do śledzenia stanu magazynowego dla każdego automatu. Zaimportuj vending.sql, przenieś zasób na swój serwer i dodaj ensure agency-vending do server.cfg. Przy pierwszym uruchomieniu resource skanuje mapę w poszukiwaniu wszystkich natywnych propów automatów z przekąskami i rejestruje je automatycznie w bazie danych. Zero ręcznego wprowadzania współrzędnych dla domyślnego rozmieszczenia automatów.

Przedmioty wydawane przez automaty muszą istnieć w rejestrze przedmiotów twojego frameworka. Config zawiera standardowe nazwy jedzenia i napojów dla QBCore oraz ESX. Niestandardowe nazwy przedmiotów wymagają zmiany tylko jednej linii dla danego typu automatu.

Opcje konfiguracji

Ten config.lua obejmuje zarówno zachowanie automatu, jak i ustawienia ekonomii:

• Stan magazynowy na automat, ile jednostek mieści każdy automat przed koniecznością uzupełnienia. Domyślnie: 50.
• Metoda uzupełniania, automatyczne uzupełnianie czasowe (proste), uzupełnianie przez graczy (rola ekonomiczna) lub uzupełnianie tylko przez administratora.
• Wymóg pracy przy uzupełnianiu, opcjonalnie ogranicz uzupełnianie zapasów do graczy z pracą dostawcy lub sprzedawcy.
• Podział zysków, procent przychodu ze sprzedaży, który trafia do gracza, który jako ostatni uzupełnił automat.
• Nadpisania typów maszyn, ręcznie ustaw inną listę przedmiotów dla konkretnych modeli propów automatów.
• Czas trwania efektu, jak długo trwają buffy jedzenia/picia. Konfigurowalne dla każdego typu przedmiotu.
• Wskaźnik braku w magazynie, przełącz wizualny stan "pusty" na propach automatów.

Kompatybilność z frameworkami

Adaptery dla QBCore i ESX są w pakiecie. W przypadku standalone zaimplementuj Config.GiveItem(src, item, count) i Config.TakeMoney(src, amount). Skanowanie automatów, zarządzanie stanem magazynowym, ekonomia uzupełniania zapasów i raportowanie dla adminów są całkowicie niezależne od frameworka.

Dlaczego ma to znaczenie dla roleplay

Gęstość mapy to jeden z niedocenianych czynników wpływających na jakość serwera RP. Kiedy gracze mogą wchodzić w interakcję z większą liczbą istniejących obiektów na mapie, automatami, ławkami, śmietnikami czy drzwiami, świat sprawia wrażenie żywego, a nie tylko makiety. Agency-Vending to jeden z najprostszych sposobów, aby to osiągnąć: każdy automat staje się interaktywnym punktem ekonomicznym bez żadnego dodatkowego nakładu pracy ze strony zespołu serwera.

Rola operatora tras automatów to być może najciekawszy emergentny gameplay, jaki umożliwia ten skrypt. Postać gracza, która zarabia na życie uzupełnianiem automatów, zarządzaniem trasami i sprawdzaniem, w których dzielnicach jest duży obrót, to przyziemna, ale pełnoprawna rola RP, którą niektórzy gracze naprawdę lubią. Nie każda postać musi być przestępcą lub policjantem.

Warstwa raportowania dla administratorów to praktyczne narzędzie do monitorowania kondycji gospodarki serwera. Jeśli konkretna lokalizacja automatu jest stale pusta (duży popyt), a inna zawsze pełna (mały ruch), to przydatna informacja do rozmieszczenia niestandardowych NPC sklepikarzy lub dostosowania punktów spawnu graczy. Dane z automatów pokazują, gdzie twoi gracze rzeczywiście spędzają czas.

Często zadawane pytania

Czy mogę dodać własne lokalizacje maszyn, które nie są natywnymi propami GTA V?

Tak. Zdefiniuj własne maszyny w Config.CustomMachines ze współrzędnymi, modelem propa i listą przedmiotów. W ten sposób dodajesz automaty sprzedające wewnątrz niestandardowych wnętrz MLO, do których natywny skaner propów nie ma dostępu.

Czy gracze mogą obrabować automaty?

W pliku config.lua znajduje się opcjonalna mechanika napadu. Włącz ją i ustaw czas wyważania, szansę na niepowodzenie oraz zakres łupu. Udane napady dają część aktualnego asortymentu w postaci przedmiotów i oznaczają automat jako uszkodzony do momentu uzupełnienia zapasów. Dodaje to wątek przestępczy bez psucia ekonomii, zysk z jednego automatu jest celowo niewielki.

Jak działa podział zysków, gdy wielu graczy uzupełnia tę samą maszynę?

Gracz, który jako ostatni uzupełnił towar, ma prawo do zysków z tego automatu, dopóki się nie opróżni i nie zostanie ponownie uzupełniony. Nie ma podziału między wieloma dostawcami, ten, kto dokonał ostatniego uzupełnienia, otrzymuje zyski z kolejnego cyklu. Upraszcza to rozliczenia i tworzy naturalną rywalizację między operatorami tras dostaw.

Czy to działa wyłącznie po stronie serwera (bez zasobu klienta)?

Nie. Skanowanie automatów i interfejs interakcji działają po stronie klienta. Agency-Vending używa skryptów zarówno serwerowych, jak i klienckich. Serwer obsługuje stan magazynowy i transakcje ekonomiczne; klient obsługuje wykrywanie propów, renderowanie interfejsu i wyzwalacze odległości gracza.

Wymagania

• Serwer FiveM (QBCore, ESX lub standalone)
• oxmysql
• konto cfx.re z ważną licencją Agency-Vending
• Opcjonalnie: ox_lib (dla komponentów UI, posiada fallback w przypadku braku)

Rozbudowa ekonomii automatów

Ekonomia automatów z przekąskami sprawdza się najlepiej, gdy stanowi część szerszego systemu jedzenia i picia, a nie jedyną opcję. Oto jak skutecznie połączyć te elementy:

Gotowanie w domu (za pomocą skryptu craftingu) powinno być najtańszym sposobem na zdobycie jedzenia z najlepszymi buffami, ale wymaga składników i czasu. Automaty z przekąskami to poziom wygody: brak przygotowania, natychmiastowy zakup, umiarkowany koszt, umiarkowane buffy. Restauracje prowadzone przez graczy to poziom premium: najlepsze buffy jedzenia, najwyższy koszt, wymagają kucharza gracza. NPC z fast foodem plasują się między automatami a restauracjami.

Gdy istnieją wszystkie cztery poziomy, gracze podejmują naturalne decyzje ekonomiczne w oparciu o swoją sytuację. Gracz w trakcie misji korzysta z automatu z przekąskami, ponieważ nie może zatrzymać się w restauracji. Gracz mający czas i pieniądze idzie do restauracji prowadzonej przez graczy dla RP i buffa. Podział na poziomy tworzy istotne wybory w całej gospodarce zamiast jednej dominującej opcji.

Agency-Vending sprawdza się również jako źródło dochodu dla lokalnych przedsiębiorców w miejskim RP. Właściciel sklepu, który "posiada trasę automatów" w swojej dzielnicy, ma mechanizm pasywnego dochodu i powód, aby patrolować i bronić swojego terytorium.