Решение проблем

Проблемы, с которыми действительно сталкиваются, примерно в том порядке, в каком они возникают.

Изменение ресурса ничего не дало

restart не перечитывает fxmanifest.lua. Если вы добавили файл — например, новый язык, — сначала введите refresh в консоли, затем перезапустите. А всё, что связано с одеждой, требует полного перезапуска сервера, а не ресурса: GTA регистрирует одежду только при загрузке сервера.

`/clothdesigner` пишет, что у меня нет прав

У вас нет ACE, указанного в Config.OpenPermission (mic_clothdesigner). Выдайте его в server.cfg вашей группе или вашему идентификатору. Чтобы исключить разрешение на время тестирования, установите Config.OpenPermission = false.

«mic_cloth_addons no accesible aún» в консоли

Студия не может записывать в mic_cloth_addons. Одна из причин:

отсутствует разрешение на запись в файловую систему из mic_cloth_designer в mic_cloth_addons;
оно есть, но стоит ниже строк ensure — оно должно идти до запуска ресурсов;
mic_cloth_addons не запущен либо запускается после дизайнера;
папка была переименована либо в одном из двух fxmanifest.lua изменена строка author.

Исправьте, затем перезапустите весь сервер. См. шаг 3 в 🪛 Установка.

Студия открывается, но библиотека пуста или миниатюры не загружаются

В большинстве случаев причина та же, что выше: mic_cloth_addons не запущен либо дизайнер не может его прочитать. Проверьте, что он запускается раньше mic_cloth_designer. При первом открытии библиотеки миниатюры рендерятся и кешируются в html/previews/, поэтому первая загрузка медленнее последующих.

Я нажал Replace, а мой персонаж по-прежнему показывает старый дизайн

Так и должно быть. Игра кеширует текстуру надетой одежды на вашем клиенте; результат Replace виден после переподключения. Save (новая текстура) виден сразу.

«Slot limit reached for this garment»

У каждого предмета одежды ограниченное число слотов под текстуры. Перезапустите ресурс, чтобы он уплотнил их, удалите ненужные дизайны либо работайте с другим предметом одежды.

Импортированной одежды нет в библиотеке

После импорта нужен перезапуск сервера — иногда два: первый запуск импортирует её, а следующая загрузка регистрирует.
Имя её файла должно начинаться с префикса компонента (jbib, lowr, feet, …) и лежать в import/male/ или import/female/, если только имя уже не начинается с mp_m_ или mp_f_.
Выполните importaddons в консоли сервера: строки, начинающиеся с !, — это одежда, которую он отклонил, с указанием причины.

Импортированная одежда невидима или вызывает вылет игры

Почти всегда неверный вариант: _r для большинства брюк, _u почти для всего остального. Поменяйте и импортируйте заново. Слишком тяжёлая одежда — более 6 МБ в распакованном виде или со встроенной текстурой более примерно 3 МБ — именно по этой причине отклоняется при импорте. Если такая уже стримится и вызывает вылеты у клиентов, удалите её из mic_cloth_addons/stream/.

ИИ ничего не генерирует

Студия называет причину; консоль сервера показывает собственный ответ провайдера рядом с кодом:

Код	Что означает
`AI_NO_KEY`	Нет `GeminiAPIKey` в `shared/keys.lua` либо ключ был отклонён
`AI_DISABLED`	`Config.AI.Enabled` выключен в `shared/keys.lua`
`AI_QUOTA`	В вашем аккаунте Google AI закончилась квота либо нужно подключить оплату
`AI_RATELIMIT`	Слишком много запросов — подождите несколько секунд
`AI_BUSY`	У вас уже выполняется генерация
`AI_EMPTY_PROMPT`	Ничего не было введено
`AI_BAD_RESPONSE`, `AI_PROVIDER_FAILED`	Провайдер ответил чем-то непригодным; строка в консоли объясняет, чем именно

Если в результате остаются белые пятна, Fill white gaps закрашивает их основным цветом дизайна.

Фотографий нет, либо база данных быстро растёт

Без FivemanageToken в shared/keys.lua каждая фотография дизайна хранится внутри базы данных, а предметы ox_inventory не могут показывать свой дизайн в качестве изображения. Добавьте токен Fivemanage.

Использование предмета ничего не делает

Есть ли cloth_design в файле предметов вашего инвентаря с тем же названием, что и Config.Items.Name?
Работает ли сервер на ESX, QBCore или QBox? Предметы регистрируются через фреймворк; без него поддержки предметов нет. На QBox qbx_core должен запускаться раньше mic_cloth_designer, чтобы бридж нашёл его через слой совместимости с QBCore.
Для предмета магазина: вы нажали Save name и совпадает ли название в вашем файле предметов с ним в точности?
Перезапустили ли вы инвентарь после добавления предмета?

Надетый дизайн исчезает после переподключения

Так и должно быть. Ношение предмета длится сессию; оно не записывается в сохранённую внешность персонажа. Используйте предмет снова.

Скачанный из сети дизайн не применяется

Дизайны, которым нужна модель одежды, ещё отсутствующая на вашем сервере, сначала загружают модель. Перезапустите сервер, затем импортируйте дизайн ещё раз, чтобы завершить.

Всё на английском

Язык выбирает Config.Locale в shared/config.lua (en, es, fr, de, it, pt, pl, ru, tr, nl, cs). После изменения перезапустите.

Консоль забита строками `[ClothDesigner]`

Config.Debug по умолчанию включён. Установите false в shared/config.lua.