Instalação

Cerca de cinco minutos e uma reinicialização completa do servidor no final. O único passo que as pessoas erram é a ordem das linhas no server.cfg — leia o passo 3 duas vezes.

Antes de começar

Você precisa	Por quê
oxmysql, em execução	Designs, itens e trajes são armazenados no banco de dados
ox_lib	Os callbacks e notificações do estúdio
ESX, QBCore ou QBox (opcional)	Apenas para os itens vestíveis. Sem um, o estúdio funciona em modo standalone
ox_inventory (opcional)	Preferido para itens quando está em execução
Uma chave de API Gemini (opcional)	Apenas para o gerador de IA — gratuita em aistudio.google.com/apikey
Um token do Fivemanage (opcional)	Hospeda as fotos dos designs e itens — gratuito em fivemanage.com

1. Coloque ambas as pastas no lugar

O pacote contém dois resources. Coloque ambos, lado a lado, na sua pasta de resources — por exemplo, resources/[mic]/mic_cloth_designer e resources/[mic]/mic_cloth_addons.

2. O banco de dados — nada a fazer

As tabelas são criadas automaticamente na primeira inicialização: mic_cloth_designs e mic_cloth_imported para designs, mic_cloth_items para itens e trajes.

mic_cloth_designs.sql vem na raiz do mic_cloth_designer para quem preferir criar as duas primeiras manualmente. Você não precisa dele.

3. server.cfg — a ordem importa

Dois grupos separados de linhas, em dois lugares.

Perto do topo do server.cfg, acima de todos os ensure:

dê ao resource mic_cloth_designer as permissões ACE command.refresh, command.ensure, command.start e command.stop (quatro linhas add_ace resource.mic_cloth_designer … allow) — o estúdio reinicia o mic_cloth_addons sozinho depois que você exporta uma peça;
adicione a permissão de sistema de arquivos que permite ao mic_cloth_designer escrever em mic_cloth_addons (add_filesystem_permission mic_cloth_designer write mic_cloth_addons);
dê a quem deve usar o estúdio a permissão ACE mic_clothdesigner — por exemplo, para group.admin, ou para o identifier.discord:… de uma pessoa.

Mais abaixo, junto com os seus outros resources: ensure oxmysql, depois ox_lib, depois mic_cloth_addons, depois mic_cloth_designer. Um ensure [mic] que cubra ambos também funciona, desde que venha depois do bloco acima.

Apenas testando? Defina Config.OpenPermission = false em shared/config.lua e qualquer pessoa poderá abrir o estúdio — a permissão de escrita ainda é necessária.

4. Suas chaves

Abra mic_cloth_designer/shared/keys.lua. É um arquivo exclusivo do servidor: nada nele é enviado a um jogador. Preencha o que você usa e deixe o resto como aspas vazias.

Chave	O que faz	Necessário
`GeminiAPIKey`	O gerador de texturas por IA	Apenas para IA. Vazio = a ferramenta de IA fica desativada
`FivemanageToken`	Hospeda fotos de designs e itens	Recomendado. Vazio = as fotos são mantidas no banco de dados
`DiscordWebhook`	Registra cada geração de IA com o seu custo estimado	Opcional
`ClothNetworkKey`	Deixe vazio. A Cloth Network funciona sem ela	Não

5. Itens

Um item genérico carrega todos os designs: cloth_design (o nome é Config.Items.Name em shared/config.lua).

Item	O que faz
`cloth_design`	Veste o design armazenado nele; use-o novamente para colocar de volta o que você estava usando

As definições vêm em mic_cloth_designer/items/:

Arquivo	Para
`items/ox.lua`	ox_inventory — vai em `ox_inventory/data/items.lua`
`items/qb.lua`	QBCore — vai em `qb-core/shared/items.lua`

Nenhuma imagem vem com ele: cada item mostra a renderização do seu próprio design no ox_inventory. No QBCore, coloque um cloth_design.png em qb-inventory/html/images/ se quiser um ícone padrão. No ESX sem ox_inventory, adicione um item chamado cloth_design aos seus itens da mesma forma que adiciona qualquer outro.

Designs que você vende em lojas ganham seus próprios nomes de item mais tarde — veja 🎒 Itens.

6. Framework

Nada para alternar. A bridge de itens encontra qb-core ou es_extended sozinha e usa o ox_inventory quando ele está em execução. Defina Config.Framework em shared/config.lua como 'qb' ou 'esx' para corresponder ao seu servidor.

No QBox, a bridge o encontra através da sua compatibilidade com QBCore — qbx_core fornece qb-core — e Config.Framework permanece em 'qb': o QBox executa resources do QBCore através da sua camada de compatibilidade.

Standalone também funciona. Sem framework, o estúdio, a pré-visualização 3D, o gerador de IA e a Cloth Network funcionam normalmente; apenas a permissão ACE é necessária para abri-lo. Deixe Config.Framework em 'qb'. Os itens vestíveis são a única parte que precisa de ESX, QBCore ou QBox.

7. Reinicialização completa e depois o primeiro design

Reinicie o servidor inteiro, não apenas o resource: o GTA lê os dados de roupas quando o servidor inicializa.

No jogo, digite /clothdesigner.
Escolha uma peça da Biblioteca, pinte algo e pressione Save.

Funcionou quando o estúdio abrir com a Biblioteca, a pré-visualização 3D e o editor lado a lado, Save responder Saved, e o seu personagem estiver vestindo a peça com o seu design nela.

Para vesti-la novamente mais tarde, transforme-a num item — veja 🎒 Itens.

Antes de abrir a sua cidade

Desative Config.Debug em shared/config.lua. Ele já vem ativado e imprime cada passo no console.
Decida sobre Config.GlobalContent. Ativado (o padrão), todos com permissão no estúdio veem e editam todos os designs, itens e trajes.
Mantenha shared/keys.lua privado. Ele guarda a sua chave Gemini, o seu token Fivemanage e o seu webhook. Esvazie-o antes de entregar os seus arquivos a alguém.
Verifique quem tem mic_clothdesigner. Com uma chave Gemini configurada, cada geração de IA é cobrada de você.