Skip to main content

​
🚀 Primeiros Passos com o Skinshop

Este guia leva o dk_skinshop do download até a primeira loja funcionando no mapa.
Estas instruções são apenas para quem adquiriu o script. Caso ainda não tenha adquirido, acesse nossa loja.
Instale e teste em um servidor de desenvolvimento antes de subir para produção.A recomendação vale para qualquer script, mas aqui ela pesa mais: o dk_skinshop grava a roupa do jogador no mesmo lugar que o seu framework já usa, detectado automaticamente pelo schema do banco. Vale confirmar em um ambiente de testes que o adapter escolhido é o certo antes de expor a base de produção.A configuração, o uso e o ambiente onde o script roda são de responsabilidade do servidor. A DK Development não se responsabiliza por problemas decorrentes de instalação feita direto em produção — confira os termos de serviço.

​
1. Baixando os arquivos

Acesse o painel do cliente

Entre no painel do cliente com a conta usada na compra.

Vá até a aba Downloads

Acesse a aba Downloads e localize a Loja de Roupas.

Baixe os arquivos

Faça o download do script.
Este script requer a instalação do dk_snippets: Baixar no GitHub

​
2. Instalação no servidor

​
2.1 Organize os arquivos

1

Pause o skinshop antigo

Se o servidor já usa outro script de roupas, pare o recurso antigo antes de continuar — dois scripts vestindo o mesmo ped brigam entre si.
2

Crie a pasta de organização

Crie uma pasta chamada [dk] dentro de resources para manter os scripts da DK organizados.
3

Extraia os arquivos

Extraia dk_skinshop e dk_snippets dentro da pasta [dk].
Mantenha o license.lua que veio junto do produto. Ele é carregado antes do servidor e sem ele o script não autentica.

​
2.2 Configure o server.cfg

O driver de banco precisa iniciar antes da pasta [dk]:
Se o driver de banco também estiver dentro de [dk], coloque-o antes do dk_snippets na ordem de start da pasta — ou inicie-o separadamente antes dela.
Não é preciso importar nenhum arquivo SQL. O recurso cria as tabelas que estiverem faltando assim que o banco responde.
Reinicie o servidor.

​
3. Verificando a instalação

​
3.1 Autenticação

Ao iniciar o servidor, o console deve exibir a confirmação de autenticação:
Enquanto a licença não valida, o script abre apenas uma loja reduzida (modo dev) — sem fotos, compra ou outfits. Assim que a autenticação passa, a loja completa assume sozinha. Detalhes em Configurações do Client.

​
3.2 Armazenamento das roupas

No mesmo boot, o console informa onde a roupa do jogador será salva:
O script detecta o schema do banco sozinho e, sempre que possível, grava no mesmo lugar que o seu framework já usa — assim a roupa continua valendo no spawn e nos demais recursos.

Armazenamento das Roupas

Confira se o adapter detectado é o correto e como forçar outro.

​
4. Criando o primeiro ponto

O recurso começa sem nenhuma loja no mapa. Tudo é criado dentro do jogo.

Entre com uma conta de admin

O painel só responde a quem o framework reconhece como administrador.

Vá até o local do ponto

O ponto é criado na sua posição atual, com a direção que você estiver olhando.

Abra o painel

Digite no chat:

Clique em Criar ponto aqui

Escolha entre Loja de Roupas e Guarda-Roupa.

Preencha a aba Geral

Defina o nome do ponto, se ele aparece no mapa, quem pode usar e o raio de interação.

Escolha o que fica disponível

Em uma loja, marque as categorias vendidas. Em um guarda-roupa, os recursos liberados.

Confirme

O ponto é salvo no banco e enviado na hora para quem está online.

Painel Administrativo

Todas as opções do painel, incluindo pontos de organização, edição e remoção.

​
Testando

Aproxime-se do ponto e pressione E. A loja deve abrir com o personagem enquadrado pela câmera.
Para testar sem sair andando até um ponto, admins podem usar /skinshop (abre a loja onde você estiver) e qualquer jogador pode usar /guardaroupa.

​
5. Ativando as fotos das roupas

As fotos reais são o diferencial do script, e elas não vêm dentro do recurso — precisam ser servidas por HTTP.
1

Gere as fotos

Use o dk_autophoto, publicado gratuitamente pela DK. Ele fotografa cada peça e já salva no formato esperado.
2

Hospede as imagens

Aponte um Apache, nginx ou CDN para a pasta gerada.
3

Aponte o config

Ajuste itemImages.baseUrl em config/shared/config.lua para o endereço onde as fotos estão.
Sem fotos configuradas, a interface continua funcionando normalmente e usa o ícone da categoria no lugar da imagem. Para desligar de vez, use itemImages.enabled = false.

Fotos das Roupas

Caminho das imagens, extensão, peds addon e resolução de problemas.

​
6. Ajustes recomendados

Antes de abrir para os jogadores, vale revisar:

Preços e categorias

Preço de cada categoria, categorias em destaque e conjuntos prontos.

Slots de outfit

Quantos outfits cada jogador salva, e quantos a mais o VIP ganha.

Permissão de VIP

Qual permissão do seu framework identifica um jogador VIP.

Logs no Discord

Webhook para acompanhar compras, outfits e ações administrativas.
Mudanças nos arquivos de config/ só valem depois de reiniciar o recurso.

​
❓ Problemas comuns

O dk_snippets é dependência do manifesto. Confirme que ele está instalado com exatamente esse nome e iniciando antes do dk_skinshop.
A licença ainda não foi validada. Verifique se o IP do servidor está cadastrado e se o license.lua está no lugar. Assim que a autenticação passa, a loja completa assume sozinha.
O comando só responde a quem o framework reconhece como administrador. Confira também se adminCommand continua preenchido em config/server/config.lua — vazio desativa o registro.
Veja no console a linha Storage de roupas e confirme se o adapter detectado é o correto. Mais detalhes em Armazenamento das Roupas.

Precisa de ajuda?

Abra um ticket no nosso Discord para suporte técnico.