Установка

Около пяти минут и полный перезапуск сервера в конце. Чаще всего ошибаются в порядке строк в server.cfg — прочитайте шаг 3 дважды.

Перед началом

Что нужно	Зачем
oxmysql — запущен	Дизайны, предметы и комплекты хранятся в базе данных
ox_lib	Колбэки и уведомления студии
ESX, QBCore или QBox (необязательно)	Только для носимых предметов. Без них студия работает как standalone
ox_inventory (необязательно)	Предпочитается для предметов, если запущен
Ключ Gemini API (необязательно)	Только для генератора ИИ — бесплатно на aistudio.google.com/apikey
Токен Fivemanage (необязательно)	Хранит фотографии дизайнов и предметов — бесплатно на fivemanage.com

1. Разместите обе папки

В пакете два ресурса. Поместите оба рядом в папку ресурсов — например, resources/[mic]/mic_cloth_designer и resources/[mic]/mic_cloth_addons.

2. База данных — ничего делать не нужно

Таблицы создаются сами при первом запуске: mic_cloth_designs и mic_cloth_imported для дизайнов, mic_cloth_items для предметов и комплектов.

Файл mic_cloth_designs.sql лежит в корне mic_cloth_designer для тех, кто предпочитает создать первые две таблицы вручную. Вам он не нужен.

3. server.cfg — порядок имеет значение

Две отдельные группы строк в двух местах.

В начале server.cfg, выше каждого ensure:

выдайте ресурсу mic_cloth_designer ACE command.refresh, command.ensure, command.start и command.stop (четыре строки add_ace resource.mic_cloth_designer … allow) — студия сама перезапускает mic_cloth_addons после экспорта одежды;
добавьте разрешение файловой системы, позволяющее mic_cloth_designer записывать в mic_cloth_addons (add_filesystem_permission mic_cloth_designer write mic_cloth_addons);
выдайте тем, кто должен пользоваться студией, ACE mic_clothdesigner — например, group.admin или identifier.discord:… одного человека.

Ниже, вместе с остальными ресурсами: ensure oxmysql, затем ox_lib, затем mic_cloth_addons, затем mic_cloth_designer. ensure [mic], охватывающий оба ресурса, тоже подходит, если он стоит после блока выше.

Просто пробуете? Установите Config.OpenPermission = false в shared/config.lua, и студию сможет открыть любой — право записи при этом всё равно нужно.

4. Ваши ключи

Откройте mic_cloth_designer/shared/keys.lua. Это серверный файл: ничего из него никогда не отправляется игроку. Заполните то, чем пользуетесь, остальное оставьте пустыми кавычками.

Ключ	Что делает	Нужен ли
`GeminiAPIKey`	Генератор текстур на ИИ	Только для ИИ. Пусто = инструмент ИИ выключен
`FivemanageToken`	Хранит фотографии дизайнов и предметов	Рекомендуется. Пусто = фотографии хранятся в базе данных
`DiscordWebhook`	Логирует каждую генерацию ИИ с оценкой её стоимости	Необязательно
`ClothNetworkKey`	Оставьте пустым. Cloth Network работает и без него	Нет

5. Предметы

Один универсальный предмет несёт каждый дизайн: cloth_design (название задаётся в Config.Items.Name в shared/config.lua).

Предмет	Что делает
`cloth_design`	Надевает дизайн, сохранённый на нём; при повторном использовании возвращает прежнюю одежду

Определения лежат в mic_cloth_designer/items/:

Файл	Для чего
`items/ox.lua`	ox_inventory — добавляется в `ox_inventory/data/items.lua`
`items/qb.lua`	QBCore — добавляется в `qb-core/shared/items.lua`

Изображение для него не поставляется: на ox_inventory каждый предмет показывает рендер собственного дизайна. На QBCore положите cloth_design.png в qb-inventory/html/images/, если нужна иконка по умолчанию. На ESX без ox_inventory добавьте предмет с именем cloth_design в ваши предметы так же, как любой другой.

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

6. Фреймворк

Переключать ничего не нужно. Бридж предметов сам находит qb-core или es_extended и использует ox_inventory, когда он запущен. Установите Config.Framework в shared/config.lua в 'qb' или 'esx' в соответствии с вашим сервером.

На QBox бридж находит его через слой совместимости с QBCore (qbx_core предоставляет qb-core), а Config.Framework остаётся 'qb': QBox запускает ресурсы QBCore через свой слой совместимости.

Standalone тоже работает. Без фреймворка студия, 3D-предпросмотр, генератор ИИ и Cloth Network работают как обычно; чтобы открыть студию, нужно только ACE-разрешение. Оставьте Config.Framework равным 'qb'. Единственная часть, которой нужны ESX, QBCore или QBox, — носимые предметы.

7. Полный перезапуск, затем первый дизайн

Перезапустите весь сервер, а не только ресурс: GTA читает данные об одежде при загрузке сервера.

В игре введите /clothdesigner.
Выберите одежду в библиотеке, что-нибудь нарисуйте и нажмите Save.

Всё сработало, если студия открылась с библиотекой, 3D-предпросмотром и редактором рядом, Save ответил Saved, а ваш персонаж одет в эту одежду с вашим дизайном.

Чтобы надеть её позже, превратите её в предмет — см. 🎒 Предметы.

Перед открытием сервера

Выключите Config.Debug в shared/config.lua. По умолчанию он включён и выводит в консоль каждый шаг.
Определитесь с Config.GlobalContent. Если включено (по умолчанию), все допущенные в студию видят и редактируют каждый дизайн, предмет и комплект.
Держите shared/keys.lua в тайне. В нём ваш ключ Gemini, токен Fivemanage и вебхук. Очистите его, прежде чем передавать свои файлы кому-либо.
Проверьте, у кого есть mic_clothdesigner. Если задан ключ Gemini, каждая генерация ИИ оплачивается вами.