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

# Giveaways

> Timed draws with a persistent Enter button, role gates and auditable entries.

Entries are saved, not held in memory. The Enter button keeps working across restarts, and a reroll
draws from the same recorded entry list.

## Start one

```text theme={null}
/giveaway start prize:"Nitro Classic" duration:3d winners:3
```

| Option | Notes |
| - | - |
| `prize` | 1–200 characters |
| `duration` | `30m`, `12h`, `3d` · capped at 60 days |
| `winners` | 1–25, default 1 |
| `required_role` | Only members with this role can enter |
| `channel` | Defaults to the channel you ran it in |

You get an ephemeral confirmation with the giveaway number, winner count, close time and a jump link.

## Entering

The post carries a single **Enter (n)** button showing the live entry count. Clicking enters; the
count updates for everyone. Members without `required_role` are turned away with an explanation
rather than silently ignored.

## Managing

| Command | What it does |
| - | - |
| `/giveaway list` | Running giveaways in this server, soonest first |
| `/giveaway end <id>` | End early and draw immediately |
| `/giveaway reroll <id>` | Draw fresh winners from a finished giveaway |

Rerolling a giveaway that's still running is refused · end it first. Every winner is announced in the
giveaway's channel with the entry count and the original post linked.

Giveaway commands need **Manage Server**.

**Ending on time**

Giveaways are checked for expiry every 30 seconds, so an ending can land a few seconds late · never
silently skipped.

## Picking winners

Winners are chosen at draw time from the recorded entries. Removing someone from the server or
deleting their entry changes who can be drawn, but the entry list is never randomly re-seeded · the
same giveaway state produces the same pool.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.