# VIP on the product

On Hystore, the VIP is written on the product itself. With the **VIP system**,
the plugin takes care of everything on the server: it puts the player in the
group, counts the time, shows `/vip` with a menu, warns before it ends and
removes the VIP on its own at the end. There is no separate VIP screen.

![The server delivery of a VIP: VIP system with LuckPerms](shots/products-vip.webp)

## Turn on the VIP system

1. In **Store > Products**, create or open the VIP product.
2. In **Product Duration**, turn off **Permanent Product?** and enter the days
   (for example, 30). For a VIP that lasts forever, leave **Permanent Product?**
   on.
3. In **Server Delivery**, pick the **Delivery Server**.
4. In **How this product is delivered**, pick **VIP system**. Delivery commands
   that were already written move to the commands on activation.
5. Set up the options below and save the product.

## How the VIP is given on the server

| Option | When to use | What happens |
| --- | --- | --- |
| LuckPerms (recommended) | The server uses LuckPerms | The plugin puts the player in the group you enter. With a time limit, LuckPerms itself removes it when it ends, even with the store offline |
| Custom commands | Another permission plugin | You write the commands to add and to remove, which run when the VIP starts and when it stops |

With LuckPerms, the group is the VIP: two products with the same group (for
example 30 and 90 days, or 30 days and permanent) are the same VIP, and the time
adds up. The dashboard shows which other product shares the VIP, and the rules
apply to all of them.

> [!WARNING]
> If LuckPerms is chosen and the delivery server does not have LuckPerms
> installed, the product warns that the VIP will not be given. Install LuckPerms
> or use **Custom commands**.

## The other options

- **VIP name in game**: the name shown in `/vip`.
- **When it starts**: **At purchase**, or when the player activates it in `/vip`
  (the VIP is stored until then).
- **How the time runs**: real time (the default: it runs even with the player
  offline) or only while the player is online (it counts play time only).
- **Accepts upgrade**: whoever has a lower-priority VIP sees this VIP in **My
  VIPs** and in `/vip upgrade`, and pays only the difference.
- **Commands on activation**: run once, the first time the VIP applies (kit,
  tag, announcement).
- **Commands when it ends**: run once, when the VIP ends for good.
- In the advanced options: how many days ahead to warn about the end, the
  priority (with more than one VIP, the highest priority applies and the others
  wait paused, losing no time), the color and the menu item in the game.

Commands accept `{player}`, `{vip}`, `{dias}` (days) and `{segundos}` (seconds).
On a permanent VIP, `{dias}` is 36500.

```text Commands on activation
give {player} diamond 16
broadcast &6{player} is now {vip}!
```

> [!TIP]
> Do not put a command that adds the group forever (like `lp user {player} parent
> add vipgold`) in the commands on activation: with it, the VIP never ends. The
> VIP system itself adds and removes the group.

## VIP upgrade

With **Accepts upgrade** on, a player with a smaller VIP buys the bigger one by
paying the difference, through the store cart. The price comes from the products
on sale for each VIP: the player pays the difference in price per day times the
time left, never less than R$ 1.00. Once paid, the time that was left moves to
the new VIP. Coupons do not discount an upgrade.

## Buying again, refunds and the game

- Buying again adds time (the days times the quantity).
- A refund or cancellation removes the days of that purchase. When the VIP ends,
  the commands when it ends run and the next paused VIP applies again.
- In the game, the player uses `/vip` (profile, my VIPs, activate, switch and
  history) and `/tempovip`. They also see their VIPs on their store profile, in
  **My VIPs**.
- With PlaceholderAPI on the server, there are `%hystore_vip%`,
  `%hystore_vip_dias%` and `%hystore_vip_tempo%`.

Whoever has a VIP shows in **Players**, on the **With VIP** tab, where you give,
remove time, freeze and remove VIPs by hand. See
[Players and roles](/en/products/players/#player-vips).