Shops

System sklepów dla standardowego ekwipunku i ox_inventory: sklepy z koszykiem, sklepy z bronią, rotujący czarny rynek, oferty dnia, sprzedawcy NPC i edytor sklepów w grze.

Funkcje

• Trzy typy sklepów: sklep z koszykiem, sklep z bronią i czarny rynek. Płacisz kartą lub gotówką, na czarnym rynku brudnymi pieniędzmi.
• Serwer sprawdza ceny, sumę, wagę i odległość. Stany magazynowe tylko w kupionych sklepach. Zasady dla typu sklepu, sklepu lub przedmiotu.
• Sklepy na sprzedaż: gracze kupują sklep, ustalają ceny, przywożą towar od hurtownika i zarządzają kasą.
• Rotujący czarny rynek ze zmieniającymi się lokalizacjami, asortymentem i cenami, do tego oferty dnia w zwykłych sklepach.
• Edytor sklepów w grze z modelem NPC, scenariuszem, znacznikiem z podglądem na żywo i własnym blipem.
• Logi na Discordzie dla każdego zakupu i statystyki na żywo na Discordzie.

Instalacja

1. Wrzuć folder off_shops do swojego folderu resources.
2. Wszystkie przedmioty z config/settings/config.items.lua muszą istnieć w twoim ekwipunku – ESX: tabela items, ox_inventory: ox_inventory/data/items.lua. Broń (weapon_…) w ESX nie potrzebuje wpisu.
3. Dodaj do server.cfg – po ESX, oxmysql i swoim ekwipunku:

ensure oxmysql
ensure es_extended
ensure ox_inventory
ensure off_shops

Tabele tworzą się automatycznie i są uzupełniane przy aktualizacjach.

Konfiguracja

config/settings/config.lua

Zasady (rules) ustawiasz dla typu sklepu, sklepu lub przedmiotu: jobs, blockedJobs, minGrade i hours = { from, to } (czas w grze, 22–5 = 22:00–04:59).

config/settings/config.locations.lua – Lokalizacje

{ type = 'normal', label = 'LTD Davis', interactionType = 'ped', position = vec4(-47.02, -1758.23, 29.42, 45.05), categories = { 'food', 'drinks', 'tools' } },
{ type = 'blackmarket', interactionType = 'ped', position = vec4(14.2280, -1104.0475, 29.7970, 340.0), categories = { 'weapons', 'illegal' } },

Lokalizacje z type = 'blackmarket' to możliwe miejsca czarnego rynku – z nich activeLocations jest aktywnych jednocześnie.

Kategorie i przedmioty

food = { label = 'Essen', items = { 'bread', 'kebab', 'wrap' } }, -- kategoria
{ name = 'water', label = 'Wasser', price = 10 },                  -- przedmiot

• Opcjonalnie dla przedmiotu: max (własna maksymalna ilość), image (własny obrazek), rules (własne zasady).
• weapon_… jest traktowane jako broń: kupowana pojedynczo, z 42 nabojami w ekwipunku ESX, nie podwójnie.
• Obrazki: ESX ładuje web/dist/assets/items/<name>.png, ox_inventory używa własnych. Brakujące obrazki broni wrzuć jako web/dist/assets/weapons/<name>.png.

config/functions.lua

Logi Discord

Webhooki wpisujesz w config/settings/config.server.lua (tylko po stronie serwera): purchases loguje każdy zakup, stats to statystyki na żywo. Pusty url ('') wyłącza log.

Języki

Wszystkie teksty są w config/locales/<język>.json. Dla własnego języka skopiuj plik, przetłumacz go i ustaw locale – zostaw w nim placeholdery jak %s i {total}.

W grze

Przy sprzedawcy lub znaczniku naciśnij E (albo użyj ox_target), wybierz artykuły i zapłać. W sklepie jest koszyk, w sklepie z bronią i na czarnym rynku wybierasz jeden artykuł.

Edytor sklepów (/shopeditor)

• Po lewej są wszystkie sklepy z edytora. Sklepów z configu tam nie ma, zmieniasz je w config/settings/config.locations.lua.
• Nowy tworzy sklep na twojej aktualnej pozycji, Edytuj otwiera istniejący.
• Ustawić można typ, nazwę, kategorie, NPC lub znacznik, pozycję z kierunkiem patrzenia i blip.
• NPC: Wybierz model z listy obrazków wszystkich pedów GTA (wyszukiwanie i kategorie), do tego scenariusz i kierunek patrzenia, wszystko z podglądem na żywo w grze. Addon peda wybierasz, wpisując dokładną nazwę modelu w wyszukiwarce. Domyślny = sprzedawca z shopTypes.
• Znacznik: Typ, rozmiar, odległość od ziemi, obrót, kolor, krycie i ruch z podglądem na żywo w grze.
• Blip: włączony lub wyłączony, opcjonalnie z własną ikoną i własnym kolorem. Inaczej obowiązuje blip z shopTypes.
• Dopóki edytor jest otwarty, chodzisz WASD i rozglądasz się z wciśniętym prawym przyciskiem myszy. Potem naciśnij Ustaw pozycję.
• Po Zapisz zmiana obowiązuje od razu dla wszystkich graczy. Czarny rynek z edytora stoi na stałe i sprzedaje wszystkie artykuły swoich kategorii.

Sklepy na sprzedaż

Czy sklep można kupić, ustawiasz dla sklepów z configu przez price w config.locations.lua, a dla sklepów z edytora w edytorze sklepów (grupa Własność: Na sprzedaż, Cena zakupu). Czarnego rynku nie da się kupić. Sklepy bez właściciela sprzedają jak dotąd, bez stanów.

W grze: Przy sklepie na sprzedaż E najpierw otwiera wybór Zakupy lub Zarządzanie, przy NPC z kamerą na sprzedawcę. Jeśli sklep należy do kogoś innego, od razu otwiera się sklep. Bez właściciela Zarządzanie prowadzi do oferty, jako właściciel do panelu z zakładkami Przegląd (kasa, obrót dziś/7 dni/łącznie, wykres, prawie wyprzedane), Magazyn, Ceny, Zamówienie i Kasa (wpłata/wypłata gotówką lub na konto, historia, sprzedaż sklepu). Klienci płacą do kasy i kupują tylko to, co jest na stanie.

Dostawa: Wybierz towar, koszt idzie z kasy. Zostajesz przeteleportowany do punktu vanSpawn i wsadzony do dostawczaka – jedź do hurtownika, w znaczniku E (załadunek), wróć i zaparkuj wóz w znaczniku, potem podejdź do sprzedawcy i naciśnij E. Dopiero wtedy towar trafia na stan. Jeśli wóz zostanie zniszczony, skończy się czas lub opuścisz serwer, towar przepada (zwrot wg refundPercent). Po restarcie serwera otwarta dostawa jest w pełni zwracana.

Log Discord: webhook ownership w config/settings/config.server.lua (zakup, sprzedaż, dostawy, wpłaty/wypłaty). Zwolnij w edytorze zwalnia sklep (magazyn i kasa przepadają).

Częste problemy