⚙️ Configurações Compartilhadas

Arquivo: config/shared/config.lua É o único config lido pelos dois lados. Concentra idioma, preços, categorias, slots de outfit, conjuntos prontos e fotos das roupas.

Mudanças aqui só valem depois de reiniciar o recurso.

Visão geral

Opção	Padrão	O que faz
`locale`	`"pt-br"`	Idioma dos textos do jogo e da interface
`outfitSlots.normal`	`3`	Slots de outfit para todo jogador
`outfitSlots.vip`	`3`	Slots extras para VIP
`purchasedDiscount`	`true`	Peça já comprada volta a custar zero
`conjuntoDiscount`	`0.25`	Desconto exibido nos conjuntos prontos
`categories`	15 categorias	O catálogo da loja e do guarda-roupa
`conjuntos`	—	Looks prontos vendidos como pacote
`itemImages`	—	Fotos reais das roupas
`defaultVariations`	—	Qual variação representa “sem a peça”

Idioma

locale = "pt-br"

Vêm inclusos pt-br e en. Para criar outro idioma, copie uma das pastas em locales/, mantenha as mesmas chaves, traduza só os valores e aponte o locale para ela.

O carregador monta o dicionário pt-br primeiro e aplica o idioma escolhido por cima. Chave faltando cai no texto em português, em vez de sumir da tela.

Cada idioma é dividido em três arquivos:

Arquivo	Conteúdo
`game.lua`	Notificações e rótulos dos keybinds
`shared.lua`	Textos comuns aos dois contextos
`ui.lua`	Textos da interface

Slots de outfit

outfitSlots = {
    normal = 3,
    vip = 3,
},

Campo	Descrição
`normal`	Slots disponíveis a todos os jogadores
`vip`	Slots somados aos normais para quem é VIP

Com o padrão, um jogador comum tem 3 slots e um VIP tem 6. Quem identifica o VIP é a vipPermission, nas Configurações do Server.

Preços e descontos

purchasedDiscount

purchasedDiscount = true

Com true, uma variação já comprada volta a ser vestida de graça.

O histórico é por categoria e variação, não por textura. Se o jogador já comprou a jaqueta 4, todas as cores dela saem de graça.

Com false, toda troca é cobrada novamente — a loja passa a funcionar como aluguel, não como coleção.

conjuntoDiscount

conjuntoDiscount = 0.25

Desconto exibido no card do conjunto, de 0.0 a 1.0. O padrão 0.25 mostra 25% off sobre a soma das peças. Use 0 para desativar.

O conjuntoDiscount altera apenas o preço mostrado no card. Na hora de cobrar, o servidor soma o preço cheio de cada peça — descontando somente o que o jogador já possui, via purchasedDiscount.

Categorias

O catálogo do script. Remover uma categoria daqui a tira da loja, do guarda-roupa e dos comandos de uma vez.

["torso"] = {
    name = "Jaqueta",
    command = "jaqueta",
    price = 250,
    featured = true,
    index = 11,
    isProp = false,
},

Campo	Função
Chave (ex.: `torso`)	Identificador usado nas roupas, outfits, exports e fotos
`name`	Nome exibido na interface
`command`	Comando de chat, sem a barra. Omitido, o script gera um a partir do `name` (minúsculo, sem acento)
`price`	Preço unitário da categoria
`featured`	Destaca a categoria no painel principal da loja
`index`	Índice do componente ou prop no GTA
`isProp`	`true` para acessórios, `false` para peças de roupa

Não altere index e isProp sem necessidade: são eles que definem qual parte do personagem a categoria controla.

As 15 categorias padrão

Categoria	Chave	Comando	Preço	Destaque	`index`	`isProp`
Jaqueta	`torso`	`/jaqueta`	250	⭐	11	—
Sapatos	`shoes`	`/sapatos`	180	⭐	6	—
Camiseta	`tshirt`	`/blusa`	100	⭐	8	—
Calças	`pants`	`/calca`	100	⭐	4	—
Chapéu	`hat`	`/chapeu`	100	⭐	0	✅
Máscara	`mask`	`/mascara`	100		1	—
Mãos	`arms`	`/maos`	100		3	—
Mochila	`backpack`	`/mochila`	100		5	—
Acessório	`accessory`	`/acessorios`	100		7	—
Colete	`vest`	`/colete`	100		9	—
Adesivos	`decals`	`/adesivo`	100		10	—
Óculos	`glass`	`/oculos`	100		1	✅
Brinco	`ear`	`/brinco`	100		2	✅
Relógio	`watch`	`/relogio`	100		6	✅
Pulseira	`bracelet`	`/pulseira`	100		7	✅

Para adicionar uma categoria, crie a chave com todos os campos acima e use o index / isProp da parte do personagem que ela deve controlar.

Conjuntos prontos

Looks completos, exibidos na aba Conjuntos da loja e vendidos como pacote.

{
    name = "Executivo Clássico",
    description = "Look profissional para reuniões",
    badge = "popular",
    vip = false,
    pieces = {
        { categoryId = "torso", drawable = 4, texture = 0 },
        { categoryId = "pants", drawable = 10, texture = 0 },
        { categoryId = "shoes", drawable = 10, texture = 0 },
        { categoryId = "tshirt", drawable = 15, texture = 0 },
    },
},

Campo	Descrição
`name`	Nome exibido no card
`description`	Linha de apoio no card
`badge`	Selo do card: `"popular"`, `"new"` ou `"vip"`. Omita para nenhum
`vip`	Muda o visual do card para o estilo VIP
`pieces`	Lista de peças, cada uma com `categoryId`, `drawable` e `texture`

Montando um conjunto novo

Vista o look no jogo

Use a loja ou os comandos de categoria até chegar no visual desejado.

Abra o guarda-roupa e clique em Copiar código

O código é a lista de peças em JSON codificada em base64.

Decodifique e cole em pieces

O resultado já está no formato esperado pelo campo pieces.

O campo vip altera apenas a aparência do card e não é validado no servidor. Não use ele como trava de acesso — para restringir de verdade, use um ponto com permissão VIP.

Variações padrão

defaultVariations define qual variação representa a ausência de cada peça, por modelo de ped. É o que o botão Tirar aplica, e também o comando sem número (/blusa tira a blusa).

defaultVariations = {
    [GetHashKey("mp_m_freemode_01")] = {
        arms = { drawable = 15, texture = 0 },
        torso = { drawable = 15, texture = 0 },
        hat = { drawable = -1, texture = -1 },
    },
},

Categoria sem entrada aqui usa o padrão do GTA: variação 0 para peças de roupa e -1 (removido) para acessórios. Preencha apenas o que fugir disso.

O caso clássico nos modelos freemode é o arms: a variação 0 é uma manga, e as mãos nuas ficam na 15.

Usa peds addon no servidor? Adicione o hash do modelo aqui para que o botão Tirar funcione corretamente neles também.

Fotos das Roupas

O bloco itemImages, em uma página só para ele.

Configurações do Client

Teclas, comandos, câmera, pose e privacidade.

Informações Gerais

Scripts

Configurações Compartilhadas

⚙️ Configurações Compartilhadas

Visão geral

Idioma

Slots de outfit

Preços e descontos

purchasedDiscount

conjuntoDiscount

Categorias

As 15 categorias padrão

Conjuntos prontos

Montando um conjunto novo

Variações padrão

Fotos das Roupas

Configurações do Client

​⚙️ Configurações Compartilhadas

​Visão geral

​Idioma

​Slots de outfit

​Preços e descontos

​purchasedDiscount

​conjuntoDiscount

​Categorias

​As 15 categorias padrão

​Conjuntos prontos

​Montando um conjunto novo

​Variações padrão

Fotos das Roupas

Configurações do Client

⚙️ Configurações Compartilhadas

Visão geral

Idioma

Slots de outfit

Preços e descontos

purchasedDiscount

conjuntoDiscount

Categorias

As 15 categorias padrão

Conjuntos prontos

Montando um conjunto novo

Variações padrão