Personalização

Dois arquivos guardam tudo o que você configura, e a divisão entre eles resume-se a uma pergunta: teria problema se um jogador lesse isso? shared/config.lua é enviado para todos os clientes. shared/keys.lua é carregado apenas como script de servidor e nunca sai do servidor.

Qual arquivo decide o quê

Todos os caminhos estão dentro de mic_cloth_designer, a menos que digam o contrário.

Onde	O que decide	Aberto para edição
`shared/config.lua`	Comando, tecla de atalho, permissão, idioma, biblioteca compartilhada ou por jogador, resolução, o item, debug	Sim
`shared/keys.lua`	Suas chaves e tokens, configurações de IA, hospedagem de fotos, lista de componentes desenháveis — apenas servidor	Sim
`locales/*.lua`	Cada texto no estúdio e suas notificações; `locales/locale.lua` é o resolvedor	Sim
`items/ox.lua`, `items/qb.lua`	A definição do item `cloth_design` para ox_inventory e QBCore	Sim
`html/`	A interface do estúdio; `html/patterns/` guarda as estampas, `html/previews/` as miniaturas em cache das peças	Sem escrow, mas os scripts vêm ofuscados
`base/addon_templates/`	Modelos que o estúdio usa para construir novas peças. Não mexa	Sim
`client/`, `server/`, `bridge/`	A lógica, o gravador de arquivos, as bridges	Com escrow
`mic_cloth_addons/import/`	Onde você coloca as suas próprias peças `.ydd`	Sim
`mic_cloth_addons/stream/`, `metas/`, `fxmanifest.lua`	As peças geradas. Reescritas pelo estúdio — não edite manualmente	Gerado

Os arquivos abertos são os que estão em escrow_ignore no fxmanifest.lua.

shared/config.lua

Opção	O que faz	Padrão
`Config.Framework`	`'esx'` ou `'qb'`. Defina para corresponder ao seu servidor; a bridge de itens também detecta o framework sozinha. Use `'qb'` no QBCore, no QBox (através da compatibilidade com QBCore) e em servidor standalone	`'qb'`
`Config.Locale`	Idioma do estúdio e das suas notificações	`'en'`
`Config.Command`	Comando que abre o estúdio	`clothdesigner`
`Config.Keybind`	Uma tecla que o abre, como `'F7'`. `false` para nenhuma. Os jogadores podem redefinir nas configurações de teclas do FiveM	`false`
`Config.OpenPermission`	A permissão ACE que um jogador precisa para abrir o estúdio. `false` deixa todos entrarem	`mic_clothdesigner`
`Config.GlobalContent`	`true`: todos com permissão compartilham uma biblioteca de designs, itens e trajes. `false`: cada designer vê apenas os seus	`true`
`Config.TextureResolution`	Tamanho padrão da textura: `256`, `512` ou `1024`. O menu suspenso do editor altera isso por design, e a IA segue essa escolha	`512`
`Config.MaxDesignsPerPlayer`	Um limite de designs salvos. Presente no arquivo, mas não aplicado pela versão atual	`50`
`Config.Items.Enabled`	Itens vestíveis, trajes e itens de loja ativados ou desativados	`true`
`Config.Items.Name`	O item genérico que carrega um design	`cloth_design`
`Config.Items.Label`	Mantido para referência. Cada item é exibido com o nome do seu próprio design	`Clothing Design`
`Config.Debug`	Imprime o que o estúdio está fazendo no console. Vem ativado — desative para um servidor em produção	`true`

shared/keys.lua

Suas chaves

Chave	O que faz
`GeminiAPIKey`	Ativa o gerador de IA. Vazio = sem IA
`FivemanageToken`	Envia fotos de designs e itens para o Fivemanage e armazena apenas o link. Vazio = as fotos são mantidas no banco de dados, que cresce mais rápido
`DiscordWebhook`	Publica cada geração de IA com o prompt e um custo estimado. Vazio = desativado
`ClothNetworkKey`	Deixe vazio. O compartilhamento na Cloth Network já funciona pronto de fábrica

O gerador de IA — `Config.AI`

Pré-ajustado. A opção que vale a pena conhecer é Model, que equilibra custo e qualidade.

Opção	O que faz	Padrão
`Enabled`	IA ativada ou desativada, independentemente da chave	`true`
`Provider`	`'gemini'`, ou `'openai'` para DALL·E (a chave em `GeminiAPIKey` é então usada para a OpenAI)	`'gemini'`
`Model`	`gemini-3.1-flash-lite-image` é o mais barato, `gemini-3.1-flash-image` o equilibrado, `gemini-3-pro-image` o mais caro	`gemini-3.1-flash-image`
`GeminiImageSize`	Tamanho de saída de reserva. Normalmente não usado: a resolução do editor é que define	`512px`
`ImageSize`	Tamanho de saída apenas para OpenAI	`1024x1024`
`AspectRatio`	As texturas são quadradas	`1:1`
`Pricing`	USD por milhão de tokens de entrada e saída, usado apenas para a estimativa de custo no registro do Discord	`0.50` / `60.00`

Uma geração é executada por vez para cada jogador, com um curto tempo de recarga entre elas.

Hospedagem de fotos — `Config.Fivemanage`

Enabled e o token acima. As fotos são a renderização 3D de cada design, usadas na biblioteca, nos itens (o ox_inventory mostra como imagem do item) e nos cartões da rede.

Componentes desenháveis — `Config.Components`

Os doze slots de roupa do GTA para os quais o estúdio pode desenhar — cabeça, máscara, cabelo, braços, pernas, luvas, sapatos, acessório, bolsas, colete, decalques e partes de cima — cada um com o prefixo de arquivo que suas peças usam. Fica no lado do servidor para que não possa ser alterado por um cliente. Deixe como veio.

Permissões

Permissão	Onde	O que permite
A ACE em `Config.OpenPermission` (`mic_clothdesigner`)	`server.cfg` — para um grupo ou um identificador	Abrir o estúdio e realizar todas as ações dentro dele. Verificado no servidor sempre
`command.refresh`, `command.ensure`, `command.start`, `command.stop` para `resource.mic_cloth_designer`	Topo do `server.cfg`	Permite que o estúdio recarregue o `mic_cloth_addons` após uma exportação
Escrita no sistema de arquivos de `mic_cloth_designer` para `mic_cloth_addons`	Topo do `server.cfg`	Permite que ele salve peças
`importaddons`	Console do servidor	Comando restrito: o console, ou um administrador com a permissão ACE para ele

Comandos

Comando	Quem	O que faz
`/clothdesigner`	Jogadores com a ACE	Abre o estúdio. O nome é `Config.Command`
`importaddons`	Console do servidor	Transforma os arquivos `.ydd` que aguardam em `mic_cloth_addons/import/` em peças desenháveis. Veja 👕 Peças de Roupa

Idiomas

Onze vêm em locales/: en, es, fr, de, it, pt, pl, ru, tr, nl, cs. Defina Config.Locale e reinicie. Um texto ausente num idioma é exibido em inglês.

Para adicionar um:

Copie locales/en.lua para locales/<code>.lua e mude Locales['en'] para o seu código.
Traduza os valores, nunca as chaves, e mantenha todos os %s.
Adicione o arquivo a shared_scripts no fxmanifest.lua antes de locales/locale.lua — o resolvedor precisa carregar depois de todos os idiomas. Em seguida, dê refresh.
Defina Config.Locale para o novo código.

A interface é traduzida trocando o texto em inglês pelo seu, portanto os valores em inglês em en.lua devem permanecer exatamente como estão.

A bridge

Ambos os arquivos da bridge têm escrow; isto é o que eles fazem, para que você saiba o que esperar.

Arquivo	Para que serve
`bridge/server_bridge.lua`	Detecta `qb-core` ou `es_extended`, registra os itens utilizáveis (`RegisterUsableItem` no ESX / `CreateUseableItem` no QBCore, que o ox_inventory respeita), e entrega itens com o seu design anexado — pelo ox_inventory quando em execução, caso contrário pelo framework
`client/bridge.lua`	Notificações. Dentro do estúdio são os seus próprios alertas (toasts); fora dele, o notify do ox_lib quando está em execução, depois ESX ou QBCore, e por fim o feed do GTA

Os jogadores são identificados pelo seu identificador license:, independentemente do framework.