Instalacja

Około pięciu minut i pełny restart serwera na koniec. Jedyny krok, w którym ludzie popełniają błąd, to kolejność linijek w server.cfg — przeczytaj krok 3 dwa razy.

Zanim zaczniesz

Potrzebujesz	Dlaczego
oxmysql, uruchomiony	Projekty, przedmioty i stroje są zapisywane w bazie danych
ox_lib	Callbacki i powiadomienia studia
ESX, QBCore lub QBox (opcjonalnie)	Tylko dla przedmiotów do noszenia. Bez nich studio działa w trybie standalone
ox_inventory (opcjonalnie)	Preferowany do obsługi przedmiotów, gdy jest uruchomiony
Klucz API Gemini (opcjonalnie)	Tylko dla generatora AI — darmowy na aistudio.google.com/apikey
Token Fivemanage (opcjonalnie)	Hostuje zdjęcia projektów i przedmiotów — darmowy na fivemanage.com

1. Umieść oba foldery na miejscu

Paczka zawiera dwa zasoby (resources). Wrzuć oba obok siebie do swojego folderu resources — na przykład resources/[mic]/mic_cloth_designer oraz resources/[mic]/mic_cloth_addons.

2. Baza danych — nic nie trzeba robić

Tabele tworzą się automatycznie przy pierwszym uruchomieniu: mic_cloth_designs i mic_cloth_imported dla projektów, mic_cloth_items dla przedmiotów i strojów.

Plik mic_cloth_designs.sql znajduje się w głównym katalogu mic_cloth_designer dla osób, które wolą utworzyć dwie pierwsze tabele ręcznie. Nie musisz go używać.

3. server.cfg — kolejność ma znaczenie

Dwie osobne grupy linijek, w dwóch miejscach.

Na samej górze server.cfg, nad wszystkimi wpisami ensure:

nadaj zasobowi mic_cloth_designer uprawnienia ACE command.refresh, command.ensure, command.start oraz command.stop (cztery linijki add_ace resource.mic_cloth_designer … allow) — studio samo restartuje mic_cloth_addons po wyeksportowaniu ubrania;
dodaj uprawnienie systemu plików pozwalające mic_cloth_designer na zapis w mic_cloth_addons (add_filesystem_permission mic_cloth_designer write mic_cloth_addons);
nadaj osobom, które mają korzystać ze studia, uprawnienie ACE mic_clothdesigner — na przykład dla group.admin lub dla konkretnej osoby po identifier.discord:….

Niżej, razem z pozostałymi zasobami: ensure oxmysql, następnie ox_lib, potem mic_cloth_addons, a na końcu mic_cloth_designer. Wpis ensure [mic] obejmujący oba zasoby również zadziała, o ile znajduje się pod powyższym blokiem uprawnień.

Chcesz tylko przetestować? Ustaw Config.OpenPermission = false w shared/config.lua, a każdy będzie mógł otworzyć studio — uprawnienie do zapisu plików jest jednak nadal wymagane.

4. Twoje klucze

Otwórz mic_cloth_designer/shared/keys.lua. Jest to plik działający wyłącznie po stronie serwera: nic z jego zawartości nigdy nie trafia do gracza. Wpisz to, z czego korzystasz, a resztę zostaw jako puste cudzysłowy.

Klucz	Co robi	Wymagany
`GeminiAPIKey`	Generator tekstur AI	Tylko dla AI. Puste = narzędzie AI jest wyłączone
`FivemanageToken`	Hostuje zdjęcia projektów i przedmiotów	Zalecany. Puste = zdjęcia są trzymane w bazie danych
`DiscordWebhook`	Loguje każde wygenerowanie AI wraz z szacowanym kosztem	Opcjonalny
`ClothNetworkKey`	Zostaw puste. Cloth Network działa bez tego klucza	Nie

5. Przedmioty

Jeden uniwersalny przedmiot obsługuje każdy projekt: cloth_design (jego nazwa to Config.Items.Name w shared/config.lua).

Przedmiot	Co robi
`cloth_design`	Zakłada zapisany na nim projekt; użyj go ponownie, aby przywrócić to, co miałeś na sobie wcześniej

Definicje znajdują się w mic_cloth_designer/items/:

Plik	Dla
`items/ox.lua`	ox_inventory — wklej do `ox_inventory/data/items.lua`
`items/qb.lua`	QBCore — wklej do `qb-core/shared/items.lua`

Nie ma do niego dołączonego obrazka: w ox_inventory każdy przedmiot wyświetla render swojego własnego projektu. Na QBCore wrzuć cloth_design.png do qb-inventory/html/images/, jeśli chcesz mieć domyślną ikonę. Na ESX bez ox_inventory dodaj przedmiot o nazwie cloth_design do swoich przedmiotów tak samo, jak dodajesz każdy inny.

Projekty sprzedawane w sklepach otrzymują własne nazwy przedmiotów później — zobacz 🎒 Przedmioty.

6. Framework

Nic nie trzeba przełączać. Bridge przedmiotów sam wykrywa qb-core lub es_extended i korzysta z ox_inventory, jeśli jest uruchomiony. Ustaw Config.Framework w shared/config.lua na 'qb' lub 'esx' odpowiednio do swojego serwera.

Na QBox bridge wykrywa go poprzez warstwę kompatybilności z QBCore — qbx_core udostępnia qb-core — a Config.Framework pozostaje ustawione na 'qb': QBox uruchamia zasoby QBCore przez swoją warstwę kompatybilności.

Tryb standalone również działa. Bez frameworka studio, podgląd 3D, generator AI oraz Cloth Network działają normalnie; do otwarcia studia potrzebne jest jedynie uprawnienie ACE. Zostaw Config.Framework ustawione na 'qb'. Przedmioty do noszenia to jedyna część wymagająca ESX, QBCore lub QBox.

7. Pełny restart, a potem pierwszy projekt

Zrestartuj cały serwer, a nie tylko sam zasób: GTA wczytuje dane ubrań podczas startu serwera.

W grze wpisz /clothdesigner.
Wybierz ubranie z Biblioteki, namaluj coś i kliknij Save.

Wszystko działa poprawnie, gdy studio otwiera się z Biblioteką, podglądem 3D i edytorem obok siebie, kliknięcie Save zwraca komunikat Saved, a Twoja postać ma na sobie ubranie z Twoim projektem.

Aby założyć je ponownie później, zamień je w przedmiot — zobacz 🎒 Przedmioty.

Zanim otworzysz serwer dla graczy

Wyłącz Config.Debug w shared/config.lua. Domyślnie jest włączony i wypisuje każdy krok w konsoli.
Zdecyduj o Config.GlobalContent. Gdy jest włączone (domyślnie), każdy mający dostęp do studia widzi i edytuje wszystkie projekty, przedmioty i stroje.
Chroń plik shared/keys.lua. Znajdują się w nim Twój klucz Gemini, token Fivemanage oraz webhook. Wyczyść go przed przekazaniem plików komukolwiek.
Sprawdź, kto posiada uprawnienie mic_clothdesigner. Przy skonfigurowanym kluczu Gemini każde generowanie AI obciąża Twoje konto.