Przejdź do treści
Cała dokumentacja

Clothingstore

Sklep odzieżowy z podglądem na żywo: gracze zmieniają ubrania, zapisują stylizacje jako stroje za gotówkę i udostępniają je innym. Dzięki torbie na ubrania mogą zakładać swoje stroje także w terenie. Do tego dochodzą fryzjer i studio tatuażu z własnymi lokalizacjami, blipami i menu.

Wymagania
  • ESX Legacy (es_extended)
  • oxmysql
  • skinchanger i esx_skin (w zestawie z ESX Legacy)
  • OneSync (wymagany)
  • Dla torby na ubrania: ekwipunek z itemami ESX (tabela items), np. off_inventory

Funkcje

  • Podgląd na żywo z kamerą przy odpowiedniej części ciała. Przeciąganie obraca postać, kółko myszy przybliża.
  • 14 kategorii z opcjami Wariant i Styl.
  • Stroje dla każdej postaci: zapisywanie za stałą cenę, zakładanie, zmiana nazwy, udostępnianie i usuwanie.
  • Udostępnione: zakładaj za darmo stroje innych graczy (100 najnowszych).
  • Torba na ubrania (item clothbag): odłóż ją na ziemię i zakładaj tam swoje stroje.
  • Każdy widzi torbę i może z niej korzystać.
  • Podnieść ją może tylko właściciel. Gdy jest offline, może ją podnieść każdy.
  • Odłożone torby zostają także po restarcie.
  • /clearbags usuwa wszystkie odłożone torby.
  • Fryzjer z podglądem na żywo i kamerą przy głowie:
  • wszystkie fryzury i warianty modelu postaci, wszystkie kolory włosów z pasemkami
  • broda, brwi, włosy na klatce, makijaż, róż i szminka z kształtem, kryciem i kolorem (broda i włosy na klatce tylko dla postaci męskich)
  • Płacisz za każdą zmienioną kategorię. Anulowanie przywraca poprzedni wygląd.
  • Studio tatuażu ze wszystkimi tatuażami z GTA łącznie z DLC, odczytywanymi bezpośrednio z gry:
  • posortowane według głowy, tułowia, rąk i nóg, z wyszukiwaniem i filtrem Moje
  • podgląd na postaci, tatuowanie i usuwanie za stałą cenę
  • zapisywane dla każdej postaci i automatycznie nakładane ponownie po zalogowaniu, respawnie i każdej zmianie skina
  • Fryzjer i studio tatuażu pobierają najpierw gotówkę, resztę z banku.

Instalacja

  1. Wrzuć folder off_clothingstore do swojego folderu resources.
  2. Dodaj do server.cfg, po oxmysql, ESX i skinchanger:
cfg
ensure oxmysql
ensure es_extended
ensure skinchanger
ensure esx_skin
ensure off_clothingstore
  1. Usuń esx_clotheshop lub inne sklepy odzieżowe w tych samych miejscach.

Przy pierwszym starcie skrypt automatycznie tworzy:

  • tabele off_clothing_outfits, off_clothing_bags i off_clothing_tattoos
  • item clothbag w tabeli items, jeśli go brakuje

Konfiguracja

config/settings/config.lua

OpcjaDomyślnieOpis
serverInfo.name'OFF SCRIPTS'Nazwa serwera, widoczna w interfejsie zamiast „OFF SCRIPTS”
serverInfo.locale'de'Język: de, en, pl, fr, es, it lub nl
serverInfo.color{ 155, 89, 255 }Kolor UI (RGB)
serverInfo.design3Wygląd interfejsu: 1 = Klasyczny, 2 = Paragon, 3 = Storefront
blurtrueRozmyte tło, gdy menu torby jest otwarte. Sklep pozostaje ostry, bo widzisz w nim swoją postać
outfitPrice250Cena za zapisany strój (gotówka), 0 = za darmo
maxOutfits25Maks. liczba strojów na postać
markerDysk, 3 mOkrąg: type, size (obszar do otwierania), drawDistance, color, alpha
blipIkona 73Ikona na mapie (enabled, sprite, color, scale)
locations14 sklepówŚrodek okręgu na ziemi jako vec3
barberwł., 7 lokalizacjiFryzjer, patrz niżej
tattoowł., 6 lokalizacjiStudio tatuażu, patrz niżej

config/settings/config.categories.lua – Kategorie

Tylko te kategorie pojawiają się w sklepie i tylko one są zapisywane w strojach, w kolejności z pliku.

lua
{ icon = 'shoes', label = 'Schuhe', variant = 'shoes_1', color = 'shoes_2', camOffset = vec3(0, 0.9, -0.8) },
PoleOpis
iconbag, chain, earrings, glasses, gloves, hat, jacket, mask, ring, shirt, shoes, shorts, vest, watch lub ikona Phosphor z ph-
labelNazwa w sklepie
variant / colorWartości skinchanger dla Wariant i Styl
camOffsetKamera: x = lewo/prawo, y = odległość do przodu, z = wysokość

config/settings/config.bag.lua – Torba na ubrania

OpcjaDomyślnieOpis
enabledtruefalse = torba na ubrania całkowicie wyłączona (bez itemu, bez toreb)
item'clothbag'Nazwa itemu, tworzona przy starcie w tabeli items
weight1Waga itemu
model'prop_cs_heist_bag_02'Obiekt torby na ziemi
max1Tyle toreb gracz może odłożyć jednocześnie
distance2.0Odległość w metrach do używania i podnoszenia
clearCommand'clearbags'Komenda, która usuwa wszystkie odłożone torby, '' = wyłączona
clearGroups{ 'projektleitung' }Grupy, które mogą używać komendy (konsola serwera zawsze)

Przy enabled = false odłożone torby zostają w bazie danych. Wracają, gdy tylko torba zostanie znowu włączona.

config/settings/config.lua – Fryzjer i studio tatuażu

Oba mają własne lokalizacje i blipy, okrąg (marker) jest taki sam jak przy sklepie.

lua
barber = {
  enabled = true,
  price = 150,
  blip = { enabled = true, sprite = 71, color = 0, scale = 0.8 },
  locations = { vec3(-814.3, -183.8, 36.6), ... },
},
OpcjaDomyślnieOpis
enabledtruefalse = fryzjer lub studio tatuażu całkowicie wyłączone
price150 / 500Fryzjer: cena za zmienioną kategorię · Studio tatuażu: cena za tatuaż, 0 = za darmo
removePrice250Tylko studio tatuażu: cena za usunięcie tatuażu, 0 = za darmo
blipIkona 71 / 75Ikona na mapie (enabled, sprite, color, scale)
locations7 / 6 lokalizacjiŚrodek okręgu na ziemi jako vec3

Płatność pobiera najpierw gotówkę, resztę z banku. Ceny istnieją tylko na serwerze, klient nie może ich zmienić. Tatuaże są zapisywane w tabeli off_clothing_tattoos, maksymalnie 100 na postać.

config/functions.lua

Tutaj podłączasz własne skrypty.

FunkcjaStronaDo czego
Notify(source, message, type)SerwerKomunikat do gracza (torba na ubrania, /clearbags)
Notify(message, type)KlientKomunikat na kliencie (np. za daleko, brak modelu freemode w studiu tatuażu)
HelpNotify(text)KlientTekst pomocy w okręgu przed sklepem, fryzjerem i studiem tatuażu (domyślnie: ESX.ShowHelpNotification)

Wersja serwerowa wysyła komunikat bezpośrednio przez ESX. Jeśli używasz własnego skryptu powiadomień, dostosuj obie funkcje Notify.

Języki

Wszystkie teksty są w config/locales/<język>.json, waluta i format liczb w ui (currency, intl). Dla własnego języka skopiuj plik, przetłumacz go i ustaw serverInfo.locale. Placeholdery takie jak %d i {price} muszą zostać. Nazwy kategorii są w config/settings/config.categories.lua (label). Nazwy kategorii fryzjera i stref ciała są w ui.barber.groups i ui.tattoo.zones, nazwy tatuaży pochodzą z GTA w języku gry.

W grze

Sklep

Naciśnij E w okręgu przed sklepem, WYJDŹ lub ESC zamyka.

  • Ubrania: zmieniaj elementy i zapisz je jako strój.
  • Zapisane: zakładaj, zmieniaj nazwę, udostępniaj i usuwaj swoje stroje.
  • Udostępnione: zakładaj stroje innych graczy.

Torba na ubrania

  • Odkładanie: użyj itemu clothbag w ekwipunku, torba zostanie odłożona na ziemię przed tobą. Nie działa to w pojeździe, po śmierci ani w innym wymiarze.
  • Nad torbą widać [E] Użyj. Właściciel widzi dodatkowo [H] Podnieś. Gdy właściciel jest offline, wszyscy widzą [H] Podnieś.
  • E otwiera po lewej listę twoich zapisanych strojów. Załóż zakłada strój, a lista zostaje otwarta. ESC lub WYJDŹ ją zamyka, tak samo gdy się oddalisz.
  • H wkłada torbę z powrotem do ekwipunku. Klawisz zmienisz w ustawieniach klawiszy FiveM.

Fryzjer

Naciśnij E w okręgu przed fryzjerem. Kapelusz i maska są zdejmowane na czas podglądu, kamera pokazuje głowę.

  • Wybierz kategorię u góry: Włosy, Broda, Brwi, Włosy na klatce, Makijaż, Róż lub Szminka.
  • Kształt i Wariant zmieniasz strzałkami lub klikając liczbę, Krycie suwakiem, Kolor i Pasemka w palecie kolorów.
  • Przeciąganie obraca postać, kółko myszy przybliża.
  • Zapłać pokazuje koszt (cena × zmienione kategorie) i zapisuje wygląd. Anuluj, WYJDŹ lub ESC resetuje wszystko, co nie zostało jeszcze opłacone.

Studio tatuażu

Naciśnij E w okręgu przed studiem. Postać zostaje rozebrana na czas podglądu, po wyjściu ubrania wracają.

  • Wybierz strefę u góry, kamera przesuwa się tam. Liczba pokazuje wytatuowane / wszystkie tatuaże strefy.
  • Kliknięcie tatuażu pokazuje go na postaci, kolejne kliknięcie go ukrywa. Szukaj tatuażu filtruje po nazwie, Moje pokazuje tylko wytatuowane.
  • Wytatuuj kupuje tatuaż, Usuń usuwa wytatuowany tatuaż za cenę usunięcia.
  • Gotowe, WYJDŹ lub ESC zamyka studio.

Komendy

KomendaKtoCo się dzieje
/clearbagsGrupy z clearGroups, konsola serweraUsuwa wszystkie odłożone torby. Właściciele, którzy są online, dostają swój item z powrotem. Torby graczy offline są tylko usuwane.

Konsola

Przy starcie skrypt sprawdza konfigurację i zgłasza błędy oraz wskazówki w konsoli serwera. Jeśli wszystko jest w porządku, pojawi się tam „uruchomiono pomyślnie”. Jeśli brakuje tego komunikatu, przeczytaj błędy powyżej, popraw je i zrestartuj. Gdy item clothbag zostanie utworzony od nowa, konsola również to zgłosi. Jeśli fryzjer lub studio tatuażu jest włączone, ale nie ma locations, pojawi się ostrzeżenie.

Częste problemy

ProblemRozwiązanie
Po E nic się nie dziejeStań na środku okręgu. skinchanger i esx_skin muszą startować wcześniej.
Okrąg unosi się lub jest w ziemiDostosuj wysokość (z) w locations.
Wygląd znika po ponownym połączeniuTylko zapisanie lub założenie zachowuje wygląd, odrzucenie resetuje wszystko.
Kategoria pokazuje tylko 0 wariantówTen element nie istnieje dla twojego modelu postaci (GTA lub addony z ubraniami).
Torba jest niewidocznaSprawdź model w config/settings/config.bag.lua, obiekt musi istnieć w GTA.
Brak itemu clothbagSprawdź konsolę. Jeśli item nie zostanie utworzony, dodaj go ręcznie do tabeli items.
Brak [H] PodnieśPodnieść może tylko właściciel. Inni dopiero, gdy właściciel jest offline.
H niczego nie podnosiW ustawieniach klawiszy FiveM sprawdź przy „Podnieś torbę na ubrania”, czy nie jest ustawiony inny klawisz.
„Odłożyłeś już torbę.”Najpierw podnieś swoją torbę lub zwiększ max.
Brak tatuaży po zmianie skinaSą automatycznie nakładane ponownie chwilę później. Nie używaj innych skryptów, które same ustawiają tatuaże.
„Tatuaże są dostępne tylko dla zwykłych postaci”Tatuaże mają tylko mp_m_freemode_01 i mp_f_freemode_01.
U fryzjera brakuje brody i włosów na klatceUkryte dla postaci kobiecych, jak w GTA Online.
Wygląd od fryzjera znika po ponownym połączeniuTylko Zapłać zapisuje wygląd, anulowanie go resetuje.

Jeszcze nie kupiony?

Zobacz Clothingstore w sklepie