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

# giveaways

Simple, reliable giveaways with reactions or buttons for entry.

## Slash commands

{% hint style="info" %}
Mods only (Manage Server).
{% endhint %}

| Command                                          | Description                         |
| ------------------------------------------------ | ----------------------------------- |
| `/gstart prize duration winners? required_role?` | Start a giveaway                    |
| `/gend giveaway_id`                              | End a running giveaway immediately  |
| `/greroll giveaway_id`                           | Reroll winners on an ended giveaway |

## Duration format

Accepts a human-readable string:

* `30s`, `5m`, `2h`, `1d`
* Combine like `1h30m` if you want.
* Max: 30 days.

## Entry restriction

Optional `required_role` — only members with this role can enter.\
Non-matching entries are silently rejected.

## Winner rolling

* Random uniform pick from eligible entrants.
* Winners are DM'd + pinged in the giveaway channel.
* `/greroll` re-picks from the same entrant pool (excluding previously-won winners).

## Dashboard: `/dashboard/giveaways`

* Live list of running giveaways with countdowns.
* End-early and reroll buttons.
* History of past giveaways with the winner list.