Solução de Problemas

Os problemas que as pessoas realmente enfrentam, aproximadamente na ordem em que acontecem.

Uma alteração no resource não fez efeito

restart não relê o fxmanifest.lua. Se você adicionou um arquivo — um novo idioma, por exemplo — digite refresh no console primeiro e depois reinicie. E qualquer coisa relacionada a peças de roupa precisa de uma reinicialização completa do servidor, não apenas do resource: o GTA só registra roupas quando o servidor inicializa.

`/clothdesigner` diz que não tenho permissão

Está faltando a permissão ACE nomeada em Config.OpenPermission (mic_clothdesigner). Conceda-a no server.cfg ao seu grupo ou ao seu identificador. Para descartar problemas de permissão durante os testes, defina Config.OpenPermission = false.

“mic_cloth_addons no accesible aún” no console

O estúdio não consegue escrever em mic_cloth_addons. É uma destas causas:

a permissão de escrita no sistema de arquivos de mic_cloth_designer para mic_cloth_addons está faltando;
ela está lá, mas abaixo das linhas ensure — ela deve vir antes de os resources iniciarem;
mic_cloth_addons não foi iniciado, ou inicia depois do designer;
uma pasta foi renomeada, ou a linha author foi alterada em um dos dois arquivos fxmanifest.lua.

Corrija isso e reinicie o servidor inteiro. Veja o passo 3 de 🪛 Instalação.

O estúdio abre, mas a Biblioteca está vazia, ou as miniaturas nunca carregam

Na maioria das vezes é a mesma causa acima: mic_cloth_addons não está em execução, ou o designer não consegue lê-lo. Verifique se ele é iniciado antes do mic_cloth_designer. Na primeira vez que a Biblioteca abre, as miniaturas são renderizadas e salvas em cache em html/previews/, por isso o primeiro carregamento é mais lento que os demais.

Pressionei Replace e meu personagem ainda mostra o design antigo

Comportamento esperado. O jogo mantém a textura de uma peça vestida em cache no seu cliente; um Replace aparece depois que você reconectar. Save (uma nova textura) aparece imediatamente.

“Slot limit reached for this garment”

Cada peça tem um número limitado de slots de textura. Reinicie o resource para que ele possa compactá-los, exclua designs que você não precisa mais ou desenhe numa peça diferente.

Uma peça importada não aparece na Biblioteca

Ela precisa de uma reinicialização do servidor após a importação — às vezes duas: a primeira inicialização importa a peça, a inicialização seguinte a registra.
O nome do arquivo deve começar com um prefixo de componente (jbib, lowr, feet, …) e ficar em import/male/ ou import/female/, a menos que o nome já comece com mp_m_ ou mp_f_.
Execute importaddons no console do servidor: as linhas que começam com ! são peças que ele recusou, junto com o motivo.

Uma peça importada fica invisível ou trava o jogo

Quase sempre é a variante errada: _r para a maioria das calças, _u para quase todo o resto. Troque a variante e importe novamente. Uma peça muito pesada — acima de 6 MB descompactada ou com uma textura embutida acima de cerca de 3 MB — é recusada na importação exatamente por esse motivo. Se uma já estiver sendo transmitida e travando os clientes, remova-a de mic_cloth_addons/stream/.

A IA não gera nada

O estúdio informa o motivo; o console do servidor mostra a resposta do próprio provedor ao lado de um código:

Código	O que significa
`AI_NO_KEY`	Nenhuma `GeminiAPIKey` em `shared/keys.lua`, ou a chave foi rejeitada
`AI_DISABLED`	`Config.AI.Enabled` está desativado em `shared/keys.lua`
`AI_QUOTA`	Sua conta do Google AI está sem cota ou precisa de faturamento ativado
`AI_RATELIMIT`	Muitas requisições — aguarde alguns segundos
`AI_BUSY`	Você já tem uma geração em andamento
`AI_EMPTY_PROMPT`	Nada foi digitado
`AI_BAD_RESPONSE`, `AI_PROVIDER_FAILED`	O provedor respondeu com algo inutilizável; a linha do console diz o que foi

Se o resultado deixar manchas brancas, Fill white gaps pinta-as com a cor principal do design.

As fotos estão faltando ou o banco de dados está crescendo rápido

Sem um FivemanageToken em shared/keys.lua, cada foto de design é armazenada dentro do banco de dados, e os itens do ox_inventory não conseguem mostrar o design como imagem. Adicione um token do Fivemanage.

Usar o item não faz nada

O cloth_design está no arquivo de itens do seu inventário, com o mesmo nome de Config.Items.Name?
O servidor está rodando ESX, QBCore ou QBox? Os itens são registrados através do framework; não há suporte a itens sem um. No QBox, o qbx_core deve iniciar antes do mic_cloth_designer para que a bridge o encontre através da compatibilidade com QBCore.
Para um item de loja: você pressionou Save name, e o nome no seu arquivo de itens corresponde exatamente a ele?
Você reiniciou o inventário depois de adicionar o item?

Um design vestido desaparece após reconectar

Comportamento esperado. Vestir um item dura pela sessão; ele não é gravado na aparência salva do personagem. Use o item novamente.

Um design baixado da rede não é aplicado

Designs que precisam de um modelo de peça que o seu servidor ainda não tem baixam o modelo primeiro. Reinicie o servidor e depois importe o design novamente para concluir.

Tudo está em inglês

Config.Locale em shared/config.lua escolhe o idioma (en, es, fr, de, it, pt, pl, ru, tr, nl, cs). Reinicie após alterá-lo.

O console está cheio de linhas `[ClothDesigner]`

Config.Debug já vem ativado. Defina-o como false em shared/config.lua.