# VIP no produto

Na Hystore, o VIP é escrito no próprio produto. Com o **Sistema de VIP**, o plugin
cuida de tudo no servidor: coloca o jogador no grupo, conta o tempo, mostra o
`/vip` com menu, avisa antes de acabar e tira o VIP sozinho no fim. Não existe
uma tela de VIP à parte.

![A entrega no servidor de um VIP: Sistema de VIP com LuckPerms](shots/products-vip.webp)

## Ligar o Sistema de VIP

1. Em **Loja > Produtos**, crie ou abra o produto do VIP.
2. Em **Duração do Produto**, desligue **Produto Permanente?** e informe os dias
   (por exemplo, 30). Para um VIP para sempre, deixe **Produto Permanente?**
   ligado.
3. Em **Entrega no Servidor**, escolha o **Servidor de Entrega**.
4. Em **Como este produto é entregue**, escolha **Sistema de VIP**. Os comandos
   de entrega que já estavam escritos vão para **Comandos ao ativar**.
5. Configure as opções abaixo e salve o produto.

## Como dar o VIP no servidor

| Opção | Quando usar | O que acontece |
| --- | --- | --- |
| LuckPerms (recomendado) | O servidor usa o LuckPerms | O plugin põe o jogador no grupo que você informar. Com prazo, o próprio LuckPerms tira quando acaba, mesmo com a loja fora do ar |
| Comandos próprios | Outro plugin de permissão | Você escreve os comandos de colocar e de tirar, que rodam quando o VIP começa e quando para de valer |

Com o LuckPerms, o grupo é o VIP: dois produtos com o mesmo grupo (por exemplo 30
e 90 dias, ou 30 dias e permanente) são o mesmo VIP, e o tempo soma. O painel
mostra **Mesmo VIP de** e o nome do outro produto, e as regras valem para todos.

> [!WARNING]
> Se o LuckPerms estiver escolhido e o servidor de entrega não tiver o LuckPerms
> instalado, o produto avisa que o VIP não vai entrar. Instale o LuckPerms ou use
> **Comandos próprios**.

## As outras opções

- **Nome do VIP no jogo**: o nome que aparece no `/vip`.
- **Quando começa a valer**: **Na hora da compra**, ou quando o jogador ativar no
  `/vip` (o VIP fica guardado até lá).
- **Como o tempo passa**: **Corrido** (o padrão: passa mesmo com o jogador
  offline) ou **Só enquanto o jogador está online** (conta só o tempo de jogo).
- **Aceita upgrade**: quem tem um VIP de prioridade menor vê este VIP em **Meus
  VIPs** e no `/vip upgrade`, e paga só a diferença.
- **Comandos ao ativar**: rodam uma vez, na primeira vez que o VIP vale (kit, tag,
  anúncio).
- **Comandos ao acabar**: rodam uma vez, quando o VIP acaba de vez.
- Em **Avançado**: com quantos dias de antecedência avisar o fim, a prioridade
  (com mais de um VIP, vale o de maior prioridade e os outros esperam pausados,
  sem perder tempo), a cor e o item do menu no jogo.

Os comandos aceitam `{player}`, `{vip}`, `{dias}` e `{segundos}`. No permanente,
`{dias}` vale 36500.

```text Comandos ao ativar
give {player} diamond 16
broadcast &6{player} agora é {vip}!
```

> [!TIP]
> Não use um comando que põe o grupo para sempre (como `lp user {player} parent
> add vipouro`) em **Comandos ao ativar**: com ele o VIP nunca acaba. Quem coloca
> e tira o grupo é o próprio Sistema de VIP.

## Upgrade de VIP

Com **Aceita upgrade** ligado, o jogador com um VIP menor compra o maior pagando
a diferença, pelo carrinho da loja. O preço sai dos produtos à venda de cada VIP:
o jogador paga a diferença do preço por dia vezes o tempo que falta, nunca menos
de R$ 1,00. Pago o pedido, o tempo que faltava vai para o VIP novo. O cupom não
desconta do upgrade.

## Comprar de novo, estorno e o jogo

- Comprar de novo soma tempo (os dias vezes a quantidade).
- Estorno ou cancelamento tira os dias daquela compra. Quando o VIP acaba, os
  comandos ao acabar rodam e o próximo VIP pausado volta a valer.
- No jogo, o jogador usa `/vip` (perfil, meus VIPs, ativar, trocar e histórico) e
  `/tempovip`. Ele vê os VIPs também no perfil da loja, em **Meus VIPs**.
- Com o PlaceholderAPI no servidor, existem `%hystore_vip%`, `%hystore_vip_dias%`
  e `%hystore_vip_tempo%`.

Quem tem VIP aparece em **Jogadores**, na aba **Com VIP**, onde você dá, tira
tempo, congela e remove VIPs à mão. Veja [Jogadores e cargos](/pt/products/players/#vips-dos-jogadores).