> For the complete documentation index, see [llms.txt](https://docs.moodymusic.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moodymusic.xyz/features/premium-slots.md).

# Premium Slots

Moody Music uses a **slot-based premium architecture**. Instead of tying a subscription to a single server, you purchase slots that you can activate on any server you manage.

## How Slots Work

| Concept            | Description                                                                              |
| ------------------ | ---------------------------------------------------------------------------------------- |
| **Slot**           | A unit of premium capacity. Each slot lets you activate premium on one server.           |
| **UserPremium**    | Your personal premium account that tracks your total slots, used slots, and expiry date. |
| **Server Premium** | A premium activation applied to a specific Discord server.                               |

## Plans

| Plan    | Duration | Slots  |
| ------- | -------- | ------ |
| Monthly | 30 days  | 1 slot |
| Yearly  | 365 days | 1 slot |

## Activating Premium

Once you have a premium subscription, use the `/prem activate` command to assign a slot to a server:

```
/prem activate <guild-id>
```

This consumes one slot from your `UserPremium` account. The server gains all premium features (24/7 mode, audio filters, custom branding, etc.) until the slot expires or you deactivate it.

## Deactivating Premium

To free a slot for use on a different server:

```
/prem deactivate <guild-id>
```

The server's premium is revoked immediately, and the slot returns to your available balance.

## Checking Your Status

```
/prem info
```

Shows your current slot usage, expiry date, and which servers have premium activated through your slots.

## Slot Lifecycle

1. You purchase a plan → 1 slot added to your `UserPremium.totalSlots`
2. You activate a server → `UserPremium.usedSlots` increases by 1
3. The subscription expires → all activated servers are automatically deactivated
4. You can manually deactivate at any time to reassign the slot