Rozwiązywanie problemów

Problemy, na które użytkownicy faktycznie natrafiają, mniej więcej w kolejności, w jakiej się pojawiają.

Zmiana w zasobie nic nie dała

Komenda restart nie wczytuje ponownie pliku fxmanifest.lua. Jeśli dodałeś nowy plik — na przykład nowy język — najpierw wpisz w konsoli refresh, a dopiero potem zrestartuj zasób. Ponadto wszystko, co wiąże się z modelami ubrań, wymaga pełnego restartu serwera, a nie samego zasobu: GTA rejestruje ubrania wyłącznie podczas startu serwera.

`/clothdesigner` zwraca komunikat o braku uprawnień

Brakuje Ci uprawnienia ACE określonego w Config.OpenPermission (mic_clothdesigner). Nadaj je w pliku server.cfg dla swojej grupy lub swojego identyfikatora. Aby wykluczyć problem z uprawnieniami na czas testów, ustaw Config.OpenPermission = false.

“mic_cloth_addons no accesible aún” w konsoli

Studio nie może zapisywać plików w mic_cloth_addons. Przyczyną jest jedna z poniższych sytuacji:

brakuje uprawnienia zapisu w systemie plików z mic_cloth_designer do mic_cloth_addons;
uprawnienie jest wpisane, ale znajduje się pod linijkami ensure — musi znajdować się przed uruchomieniem zasobów;
zasób mic_cloth_addons nie jest uruchomiony lub uruchamia się po designerze;
zmieniono nazwę któregoś z folderów lub zmodyfikowano linijkę author w jednym z dwóch plików fxmanifest.lua.

Popraw to, a następnie zrestartuj cały serwer. Zobacz krok 3 w sekcji 🪛 Instalacja.

Studio się otwiera, ale Biblioteka jest pusta lub miniatury nigdy się nie ładują

W większości przypadków przyczyna jest taka sama jak wyżej: mic_cloth_addons nie działa lub designer nie może go odczytać. Upewnij się, że jest uruchamiany przed mic_cloth_designer. Przy pierwszym otwarciu Biblioteki miniatury są renderowane i zapisywane w pamięci podręcznej w html/previews/, dlatego pierwsze ładowanie trwa dłużej niż kolejne.

Kliknąłem Replace, ale moja postać nadal ma na sobie stary projekt

To normalne zjawisko. Gra przechowuje teksturę założonego ubrania w pamięci podręcznej po stronie klienta; efekt działania Replace będzie widoczny dopiero po ponownym połączeniu z serwerem (reconnect). Opcja Save (nowa tekstura) jest widoczna od razu.

“Slot limit reached for this garment”

Każde ubranie posiada ograniczoną liczbę slotów na tekstury. Zrestartuj zasób, aby mógł je uporządkować, usuń projekty, których już nie potrzebujesz, lub stwórz projekt na innym ubraniu.

Zaimportowane ubranie nie pojawia się w Bibliotece

Po imporcie wymagany jest restart serwera — czasami dwukrotny: pierwszy start importuje plik, a kolejny rejestruje go w grze.
Nazwa pliku musi zaczynać się od prefiksu komponentu (jbib, lowr, feet, …) i znajdować się w import/male/ lub import/female/, chyba że nazwa zaczyna się już od mp_m_ lub mp_f_.
Wpisz importaddons w konsoli serwera: linijki zaczynające się od ! oznaczają odrzucone ubrania wraz z podaniem powodu.

Zaimportowane ubranie jest niewidoczne lub zawiesza grę (crash)

Prawie zawsze oznacza to niewłaściwy wariant: _r dla większości spodni, _u dla niemal wszystkiego innego. Zamień końcówkę i zaimportuj plik ponownie. Zbyt ciężkie ubrania — powyżej 6 MB po rozpakowaniu lub z wbudowaną teksturą przekraczającą około 3 MB — są odrzucane podczas importu właśnie z tego powodu. Jeśli takie ubranie jest już streamowane i powoduje crashe u graczy, usuń je z mic_cloth_addons/stream/.

AI nic nie generuje

Studio wyświetla powód, a konsola serwera pokazuje dokładną odpowiedź dostawcy obok kodu błędu:

Kod	Co oznacza
`AI_NO_KEY`	Brak klucza `GeminiAPIKey` w `shared/keys.lua` lub klucz został odrzucony
`AI_DISABLED`	Opcja `Config.AI.Enabled` jest wyłączona w `shared/keys.lua`
`AI_QUOTA`	Twoje konto Google AI wyczerpało limit (quota) lub wymaga podpięcia płatności
`AI_RATELIMIT`	Zbyt wiele zapytań — odczekaj kilka sekund
`AI_BUSY`	Jedno generowanie jest już w trakcie wykonywania
`AI_EMPTY_PROMPT`	Nie wpisano żadnego opisu
`AI_BAD_RESPONSE`, `AI_PROVIDER_FAILED`	Dostawca zwrócił odpowiedź, której nie da się użyć; szczegóły znajdują się w konsoli

Jeśli wygenerowana tekstura ma białe plamy, przycisk Fill white gaps zamaluje je głównym kolorem projektu.

Brakuje zdjęć lub baza danych bardzo szybko rośnie

Bez wpisanego FivemanageToken w shared/keys.lua każde zdjęcie projektu jest zapisywane bezpośrednio w bazie danych, a przedmioty w ox_inventory nie mogą wyświetlać projektu jako swojej ikony. Dodaj token Fivemanage.

Użycie przedmiotu nic nie robi

Czy cloth_design znajduje się w pliku przedmiotów Twojego ekwipunku pod dokładnie taką samą nazwą jak w Config.Items.Name?
Czy serwer działa na ESX, QBCore lub QBox? Przedmioty są rejestrowane przez framework; bez niego obsługa przedmiotów nie działa. Na QBox zasób qbx_core musi uruchomić się przed mic_cloth_designer, aby bridge wykrył go przez warstwę kompatybilności z QBCore.
W przypadku przedmiotu sklepowego: czy kliknąłeś Save name i czy nazwa w pliku przedmiotów zgadza się co do znaku?
Czy zrestartowałeś ekwipunek po dodaniu przedmiotu?

Założony projekt znika po ponownym połączeniu z serwerem

To normalne. Noszenie przedmiotu działa w ramach bieżącej sesji; nie jest zapisywane w stałym wyglądzie postaci w bazie danych. Użyj przedmiotu ponownie.

Pobrany z sieci projekt nie chce się nałożyć

Projekty wymagające modelu ubrania, którego Twój serwer jeszcze nie posiada, najpierw pobierają sam model. Zrestartuj serwer, a następnie zaimportuj projekt jeszcze raz, aby dokończyć.

Wszystko jest po angielsku

Za wybór języka odpowiada Config.Locale w pliku shared/config.lua (en, es, fr, de, it, pt, pl, ru, tr, nl, cs). Po zmianie zrestartuj zasób.

Konsola jest pełna linijek `[ClothDesigner]`

Opcja Config.Debug jest domyślnie włączona. Ustaw ją na false w pliku shared/config.lua.