> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dkscripts.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Apresentação
> Loja de roupas e guarda-roupas com fotos reais, outfits, compartilhamento de looks e uniformes de organização
# 👕 DK SKINSHOP — Loja de Roupas e Guarda-Roupas
O **dk\_skinshop** é um sistema completo de loja de roupas e guarda-roupas para FiveM, feito para deixar a personalização do personagem **visual, rápida e intuitiva**.
Em vez de depender só de números para achar uma peça, o jogador **vê fotos reais** do que comprou, navega pela interface com teclado ou mouse, monta combinações e compartilha os looks com outros jogadores.
Além da experiência individual, o script traz um sistema de **uniformes oficiais para organizações**: líderes criam os outfits do grupo e os membros equipam direto no guarda-roupas da facção.
***
## 🎬 Demonstração
***
## ✨ Os quatro pilares
As peças compradas aparecem com **foto de verdade**, e não como uma lista de números. Achar uma roupa vira questão de olhar, não de memorizar.
Navegação por **teclado ou mouse**, digitação direta do número da peça, carrinho com total em tempo real e personagem visível durante a prova.
Envie um look para um jogador próximo escolhendo **exatamente quais peças** entram. Quem recebe visualiza antes de confirmar.
Cada grupo ganha um guarda-roupas próprio. **Líderes criam e editam**, membros apenas equipam — com a permissão validada no servidor.
***
## 🎮 Funcionalidades detalhadas
* **Fotos reais** de cada variação comprada
* Filtro por categoria e busca rápida
* Histórico de **roupas vestidas recentemente**
* Criação e uso de **outfits salvos** (3 slots + 3 para VIP, configurável)
* **Copiar código** do look atual e **importar código** de outra pessoa
* Botão **Tirar** por peça e descarte de itens do histórico
* Troca de roupa completa em poucos cliques
* Navegação pelas peças com **teclado** ou **mouse**
* **Scroll vertical** arrastando a lista e navegação de texturas arrastando na horizontal
* **Rotação do personagem** com o mouse e zoom por scroll
* **Digitação direta** do número da peça
* Filtro para ver só o que já foi comprado
* **Carrinho** com peças de categorias diferentes e **total atualizado em tempo real**
* **Conjuntos prontos** vendidos como pacote, com desconto configurável
* Câmera que enquadra automaticamente a parte do corpo da categoria aberta
* Envio do look para um jogador próximo
* Seleção de **quais peças** entram no envio
* Quem recebe pode **visualizar no próprio personagem** antes de confirmar
* Opções de usar na hora, cancelar a visualização, copiar o código ou salvar nos próprios outfits
* Guarda-roupas exclusivo por ponto do mapa
* Líder cria o uniforme **a partir da roupa que está vestindo**
* Escolha de quais peças fazem parte, nome do outfit, edição e remoção
* Membros consultam e equipam, sem poder alterar
* Ideal para polícia, hospital, facções, empresas, eventos e cargos específicos
* Painel `/ssadmin` para criar lojas e guarda-roupas **sem editar código**
* Definição de local, nome, ícone no mapa, raio de interação e permissão
* Escolha das categorias disponíveis em cada loja
* Cargos de líder e membro nos pontos de organização
* Listagem, filtro por tipo, teleporte, edição e remoção dos pontos existentes
Cada categoria ganha um comando de chat — `/jaqueta 4 0`, `/calca 10`, `/sapatos` — para quem já sabe o número da peça e quer trocar sem abrir nada.
Veja a [lista completa de comandos](/scripts/skinshop/commands).
***
## 🛠️ Compatibilidade
O script conversa com o seu framework pela bridge do **dk\_snippets**, então funciona sem alteração em:
* **ESX** (todas as versões)
* **QBCore** e **Qbox**
* **vRP** (Creative Network, Creative V5/Summerz, vRPex)
* **Standalone** e qualquer outro framework suportado pela bridge
O acesso passa pelo `snippets.db()`, então qualquer driver MySQL já configurado no servidor serve (**oxmysql**, por exemplo).
**Não é preciso importar nenhum SQL**: o recurso cria as tabelas que faltarem assim que o banco responde.
| Tabela | Conteúdo |
| --------------------------- | ------------------------------------------------------------------ |
| `dk_skinshop_purchases` | Variações compradas por jogador |
| `dk_skinshop_outfits` | Outfits pessoais |
| `dk_skinshop_group_outfits` | Outfits de organização |
| `dk_skinshop_blips` | Lojas e guarda-roupas criados no painel |
| `dk_skinshop_clothes` | Roupa atual do jogador (só quando o armazenamento próprio é usado) |
* **dk\_snippets** (obrigatório) — [Download](https://github.com/potter7k/dk_snippets/releases/latest)
* Um **driver MySQL** já ativo no servidor (ex.: `oxmysql`)
* FiveM atualizado, com Lua 5.4
As fotos das roupas são geradas pelo **dk\_autophoto**, publicado gratuitamente pela DK. Veja em [Fotos das Roupas](/scripts/skinshop/configs/item-images).
***
## 📋 Estrutura do script
```
dk_skinshop/
├── config/
│ ├── client/config.lua # Teclas, comandos, pose, câmera, privacidade e hooks
│ ├── server/config.lua # Permissões, armazenamento, logs e hooks
│ └── shared/config.lua # Idioma, categorias, preços, conjuntos e fotos
├── locales/
│ ├── pt-br/ # game.lua, shared.lua, ui.lua
│ └── en/
├── modules/ # Lógica interna do client, server e shared
├── web/
│ └── build/
│ └── theme.css # Cores da interface (editável sem recompilar)
├── types.lua # Tipagem dos exports para o Lua LSP
├── license.lua # Licença do produto (não remova)
└── fxmanifest.lua
```
A pasta instalada precisa se chamar exatamente **`dk_skinshop`**. Esse nome aparece nos `require`, exports, eventos e caminhos da interface.
***
## 🔒 Segurança
O script é **ofuscado e protegido por licença**. Cada licença dá acesso a **1 endereço de IP**, que pode ser alterado quando desejado.
* Permissões de admin, VIP e de grupo checadas **sempre no servidor**
* Compra, preço e posse das peças validados server-side
* Criação, edição e remoção de outfits de organização restritas a líderes
* Webhooks e permissões ficam no config do servidor, nunca no client
***
## 💰 Adquira agora
Acesse nossa loja e adquira o script com suporte completo e atualizações gratuitas!
A instalação é oferecida **gratuitamente** para todos os compradores. Confira os [termos e condições](/terms-of-service).
Instale o script e crie a sua primeira loja.
A referência rápida de tudo que o jogador pode digitar.