> ## 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.

# Painel Administrativo

> Crie, edite e remova lojas e guarda-roupas dentro do jogo, sem editar código

# 🧰 Painel Administrativo

Os pontos do dk\_skinshop **não são configurados em arquivo**. Toda loja e todo guarda-roupa é criado dentro do jogo, pelo painel `/ssadmin`, e fica salvo no banco.

```
/ssadmin
```

<Warning>
  O comando responde **apenas a administradores**, e a checagem acontece no servidor. Ele pode ser renomeado ou desativado em `adminCommand`, nas [Configurações do Server](/scripts/skinshop/configs/sv-config).
</Warning>

***

## Gerenciador de pontos

A tela inicial lista tudo que já existe no mapa.

| Ação                 | O que faz                                  |
| -------------------- | ------------------------------------------ |
| **Criar ponto aqui** | Cria um ponto novo na sua posição atual    |
| **Filtros**          | Alterna entre Todos, Lojas e Guarda-Roupas |
| **Ir até**           | Teleporta você até o ponto selecionado     |
| **Editar**           | Reabre as configurações do ponto           |
| **Remover**          | Apaga o ponto (com confirmação)            |

<Note>
  Os pontos salvos são enviados automaticamente a quem entra no servidor — não é preciso reiniciar nada depois de criar ou editar.
</Note>

***

## Criando um ponto

<Steps>
  <Step title="Posicione-se no local" icon="location-dot">
    O ponto usa a **sua posição e direção atuais**. Vale ficar exatamente onde o jogador deve interagir.
  </Step>

  <Step title="Clique em Criar ponto aqui" icon="plus">
    Escolha entre **Loja de Roupas** e **Guarda-Roupa**.
  </Step>

  <Step title="Preencha as abas" icon="table-columns">
    O criador tem duas ou três abas, dependendo do tipo escolhido.
  </Step>

  <Step title="Confirme" icon="check">
    O ponto é salvo no banco e distribuído na hora para quem está online.
  </Step>
</Steps>

### Aba Geral

| Campo                     | O que define                                                          |
| ------------------------- | --------------------------------------------------------------------- |
| **Nome do ponto**         | Texto exibido no ícone do mapa (até 50 caracteres)                    |
| **Mostrar ícone no mapa** | Desligado, o ponto continua funcionando — só não aparece no mapa      |
| **Quem pode usar**        | Permissão de acesso (veja abaixo)                                     |
| **Raio de interação**     | Distância, em metros, dentro da qual o jogador consegue abrir o ponto |

<Tip>
  Pontos **sem ícone no mapa** são úteis para guarda-roupas de interior, esconderijos de facção ou locais que só quem sabe deve encontrar.
</Tip>

### Aba Itens — só em lojas

Marque quais **categorias** essa loja vende. Uma loja de acessórios pode oferecer só chapéu, óculos, relógio e pulseira; uma butique de luxo, só jaqueta e sapatos.

<Note>
  É preciso deixar **ao menos uma categoria ativa** para salvar.
</Note>

### Aba Recursos — só em guarda-roupas

Marque o que o jogador pode fazer nesse guarda-roupa:

| Recurso                 | Permite                              |
| ----------------------- | ------------------------------------ |
| **Equipar Roupas**      | Vestir as peças compradas            |
| **Gerenciar Outfits**   | Criar e apagar as combinações salvas |
| **Compartilhar Outfit** | Enviar o look para outro jogador     |
| **Descartar Itens**     | Jogar peças fora do histórico        |

***

## Permissões de acesso

| Permissão       | Quem acessa                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------- |
| **Qualquer um** | Todos os jogadores                                                                          |
| **VIP**         | Quem tem a permissão configurada em `vipPermission`. Administradores também contam como VIP |
| **Admin**       | Apenas administradores reconhecidos pelo framework                                          |
| **Grupo**       | Quem tiver ao menos uma das labels cadastradas como líder ou membro                         |

Ao escolher **Grupo**, dois campos a mais aparecem:

| Campo                | Uso                                                                        |
| -------------------- | -------------------------------------------------------------------------- |
| **Labels de Líder**  | Permissões do framework que identificam quem **cria e edita** os uniformes |
| **Labels de Membro** | Permissões que identificam quem apenas **consulta e usa**                  |

<Note>
  É preciso pelo menos uma label de cada tipo para salvar um ponto de grupo.
</Note>

<Card title="Outfits de Organizações" icon="users" href="/scripts/skinshop/usage/groups" horizontal>
  Como líderes e membros usam o guarda-roupa do grupo no dia a dia.
</Card>

***

## Editando e removendo

A edição reabre as mesmas abas do criador, com os valores atuais preenchidos.

<Warning>
  A edição **preserva as coordenadas** do ponto. Para mover um ponto de lugar, remova-o e crie outro na posição nova.
</Warning>

A remoção pede confirmação e é definitiva — o ponto sai do banco e do mapa de todo mundo.

***

## Atalhos úteis para testes

| Comando        | Para quê                                                                                       |
| -------------- | ---------------------------------------------------------------------------------------------- |
| `/skinshop`    | Abre a **loja completa** onde você estiver, sem criar ponto — bom para conferir peças e preços |
| `/guardaroupa` | Abre o guarda-roupa onde você estiver                                                          |

<Note>
  O `/skinshop` é **admin-only**; o `/guardaroupa` está disponível para todos os jogadores.
</Note>

***

## Automatizando pela API

Tudo que o painel faz também pode ser feito por outro script, através dos exports — abrir uma loja a partir de um NPC, de um item ou de um menu próprio.

<CardGroup cols={2}>
  <Card title="Exports" icon="code" href="/scripts/skinshop/dev/exports">
    Abrir lojas, ler compras e alterar roupas por código.
  </Card>

  <Card title="Hooks" icon="bolt" href="/scripts/skinshop/dev/hooks">
    Reagir a compras, outfits e criação de pontos.
  </Card>
</CardGroup>
