> ## Documentation Index
> Fetch the complete documentation index at: https://xrypton.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Run and Manage Discord Giveaways Easily with XRYPTON

> Start, manage, and reroll Discord giveaways with XRYPTON — supports flexible durations, multiple winners, early endings, and active giveaway listings.

XRYPTON's giveaway system makes it easy to run fair, transparent giveaways directly inside your server. Entries are tracked automatically via the 🎉 reaction, winners are picked at random when the timer expires, and you have full control to end, reroll, or cancel any giveaway at any time. All giveaway commands are available both as prefix (`,giveaway`) and slash (`/giveaway`) commands.

**Permission required for all giveaway commands:** Manage Channels

***

## Starting a Giveaway

```bash theme={null}
/giveaway start <channel> <duration> <winners> <prize>
```

| Parameter  | Description                                            |
| ---------- | ------------------------------------------------------ |
| `channel`  | The channel where the giveaway embed will be posted    |
| `duration` | How long the giveaway runs (see format examples below) |
| `winners`  | Number of winners to pick at the end                   |
| `prize`    | The name of the prize being given away                 |

**Duration format examples:**

| Input | Meaning    |
| ----- | ---------- |
| `30m` | 30 minutes |
| `1h`  | 1 hour     |
| `6h`  | 6 hours    |
| `1d`  | 1 day      |
| `7d`  | 1 week     |

The giveaway embed displays the prize name, end time (both relative and absolute), number of winners, and the host's mention. Members enter by reacting with 🎉.

***

## Example Walkthrough

<Steps>
  <Step title="Start the giveaway">
    ```bash theme={null}
    /giveaway start #giveaways 24h 3 Discord Nitro
    ```

    XRYPTON posts an embed in `#giveaways` and adds the 🎉 reaction. Members click the reaction to enter.
  </Step>

  <Step title="Wait for entries (or end it early)">
    The bot automatically picks winners when the timer expires. If you want to end it early, use the message ID:

    ```bash theme={null}
    /giveaway end 1234567890123456789
    ```
  </Step>

  <Step title="Winners are announced">
    XRYPTON edits the original embed to show the winning members. If nobody entered, the embed updates to reflect that.
  </Step>

  <Step title="Reroll if needed">
    If a winner is unreachable or you want to re-pick:

    ```bash theme={null}
    /giveaway reroll 1234567890123456789
    ```

    You can optionally specify how many new winners to pick:

    ```bash theme={null}
    /giveaway reroll 1234567890123456789 2
    ```
  </Step>
</Steps>

***

## Managing Giveaways

### End a Giveaway Early

```bash theme={null}
/giveaway end <message_id>
```

Forces the giveaway to end immediately, picking winners from current entries.

### Reroll Winners

```bash theme={null}
/giveaway reroll <message_id>
/giveaway reroll <message_id> <winner_count>
```

Picks new random winners from the existing entry pool. Defaults to 1 new winner.

### Cancel a Giveaway

```bash theme={null}
/giveaway cancel <message_id>
```

Removes the giveaway and deletes the embed message. Cancelled giveaways cannot be restored.

### List Active Giveaways

```bash theme={null}
/giveaway list
```

Displays all currently active (not yet ended) giveaways in the server. Each entry links to the giveaway message and shows the time remaining.

***

<Note>
  To use `end`, `reroll`, or `cancel`, you need the **message ID** of the giveaway embed. You can get this by right-clicking the message and selecting **Copy Message ID** (Developer Mode must be on in your Discord settings).
</Note>

<Warning>
  Removing your 🎉 reaction before the giveaway ends will remove you from the entry pool. Re-adding it will re-enter you.
</Warning>