> For the complete documentation index, see [llms.txt](https://lethium.gitbook.io/lethium-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lethium.gitbook.io/lethium-docs/gameplay/vip-perks.md).

# VIP Perks

The seven VIP tiers, their perks, how a player gets a tier, and how to edit perks.

File: `plugins/ClickEmCore/modules/vip-perks.yml`. Module id: `vip-perks`. Commands: `/vip`, `/vipperks`, `/ranks`, `/perks`, `/fly`.

{% hint style="success" %}
**Quick start**

* Change a price tag: `price-tag` of the tier (display text only).
* Give a tier: `/ceadmin vip grant <player> <tier>` or a LuckPerms group.
* Edit a perk: `perks:` of that tier, see the [reference](/lethium-docs/gameplay/vip-perks-reference.md).
* Sell ranks from a store: [Sell ranks and Gems](/lethium-docs/how-to/sell-ranks-and-gems.md).
  {% endhint %}

VIP ranks give **stat bonuses and perks** that other modules read. ClickEm never takes real money: it only shows a price tag. You sell the rank through your webstore (Tebex, BuyCraft and so on), and the store gives the LuckPerms group.

### The tiers

Listed lowest to highest. **The last tier a player qualifies for wins. Tiers do not stack.**

| Tier       | Rarity frame | Extra pet slots | Coins | Luck | Power | Max HP | Shown price |
| ---------- | ------------ | --------------- | ----- | ---- | ----- | ------ | ----------- |
| `vip`      | Common       | +1              | +5%   |      |       |        | 4.99        |
| `mvp`      | Common       | +2              | +10%  | +2%  |       |        | 9.99        |
| `elite`    | Rare         | +3              | +15%  | +3%  | +2%   |        | 14.99       |
| `supreme`  | Epic         | +4              | +20%  | +5%  | +4%   | +2%    | 24.99       |
| `legend`   | Legendary    | +5              | +27%  | +7%  | +6%   | +4%    | 39.99       |
| `ultimate` | Mythical     | +6              | +35%  | +10% | +9%   | +6%    | 64.99       |
| `clicker`  | Ancient      | +6              | +45%  | +14% | +13%  | +9%    | 99.99       |

`clicker` is the server's own top, exclusive rank. Its pet slots stop at +6 because the pet loadout row only has 9 buttons.

The full perk-by-tier table (idle bonuses, XP bonuses, discounts, gifts, free cosmetics) is on [VIP Perks: reference](/lethium-docs/gameplay/vip-perks-reference.md).

### How a player gets a tier

Any one of these:

1. They have the permission `clickem.vip.<tier>` (works with any permission plugin).
2. LuckPerms integration is on and `required-group` is their **primary group**.
3. They buy it in game, if `purchase.enabled: true` (off by default) for `purchase.cost` Coins.

Temporary ranks from the [Gems Shop](/lethium-docs/gameplay/gems-shop.md) and from [Vouchers](/lethium-docs/gameplay/vouchers.md) use LuckPerms `settemp` on `clickem.vip.<tier>`.

Flight (`/fly`) is allowed for tiers with `fly: true`, or anyone with `clickem.fly` or `essentials.fly`. It switches off inside a WorldGuard region whose id contains `fly.blocked-region-contains` (default `boss`).

> **Reference:** the key list of a tier entry is on [VIP Perks: reference](/lethium-docs/gameplay/vip-perks-reference.md).

### How to

{% tabs %}
{% tab title="Add an eighth tier" %}
Add a block at the **end** of `tiers` (order is priority). Create a LuckPerms group with the same name as `required-group`, and optionally sell it in the Gems Shop by adding it under `ranks:` in `gemsshop.yml`.
{% endtab %}

{% tab title="Change a price tag" %}
Edit `price-tag`. This only changes the menu text.
{% endtab %}

{% tab title="Give a tier to one player" %}
`/ceadmin vip grant <player> <tier>`. Or `/lp user <name> permission set clickem.vip.<tier> true`. For a limited time: `/lp user <name> permission settemp clickem.vip.<tier> true 30d`.
{% endtab %}

{% tab title="Remove a perk from a tier" %}
Delete its line under `perks:`.
{% endtab %}
{% endtabs %}

### Staff commands

`/ceadmin vip grant <player> <tier>`, `/ceadmin vip revoke <player>`.

Permissions: `clickem.vip.vip`, `clickem.vip.vip-plus`, `clickem.vip.mvp` are declared by the plugin, and every tier id works as `clickem.vip.<id>`. See [Permissions](/lethium-docs/commands/permissions.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://lethium.gitbook.io/lethium-docs/gameplay/vip-perks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.