# Giveaways

Giveaways is a highly scalable battle-tested giveaway bot capable of handling hundreds of thousands of entrants. Used during Snowsgiving and the Discord Birthday Server, Giveaways is capable of handling hundreds of thousands of entrants with ease.

Giveaways also includes a web dashboard where entrants can verify their entry status. The web dashboard is available at `https://giveaways.mrkirby153.com/giveaways/<Server ID>`. A direct link for the server can additionally be found in the `%help` menu

## Getting Started

Getting started with Giveaways is as easy as 1, 2, 3:
1. [Add](https://giveaways.mrkirby153.com/invite) giveaways to your server
2. Ensure that you have Manage Server or a configured giveaway role
3. Start a giveaway with `%start <duration> <prize>`

## Commands
| Command                                   | Description                                                                                                                  | Example                                       |
|-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------|
| %start <duration> [winners] Prize         | Starts a giveaway in the current channel                                                                                     | %start 30m 2w Steam Key                       |
| %end <message id>                         | Ends the giveaway with the given message id                                                                                  | %end 738915682699182163                       |
| %winners <message id>                     | Prints out the winners of the given giveaway                                                                                 | %winners 738915682699182163                   |
| %winners set <message id> <winner count>  | Sets the amount of winners for a giveaway                                                                                    | %winners set 738915682699182163 2             |
| %reroll <message id> [user ids to reroll] | Rerolls the given giveaway. If user ids are provided [Comma Separated], it will reroll the given users and keep the existing | %reroll 738915682699182163 651627261782523926 |
| %export                                   | Exports a CSV of all the giveaways ran on the server | %export |

### Host Commands
Giveaway hosts can start giveaways without having Manage server

| Command                | Description                               | Example                         |
|------------------------|-------------------------------------------|---------------------------------|
| %role add <role id>    | Adds the given role as a giveaway host    | %role add 404402605985628160    |
| %role remove <role id> | Removes the given role from giveaway host | %role remove 404402605985628160 |
| %role list             | Lists all giveaway host roles             | %role list                      |
  
### Configuration Commands
| Command                      | Description                                      | Example                         |
|------------------------------|--------------------------------------------------|---------------------------------|
| %configure                   | Shows the current bot configuration              | %configure                      |
| %configure set <key> <value> | Sets the given setting key to the provided value | %configure set prefix $         |
| %configure reset <key>       | Resets the given setting key to its default      | %configure reset emote          |

#### Available Keys
* `emote` - The emote used as the reaction emote.
* `prefix` - The command prefix of the bot

_Running an extremley large giveaway? Join the support server_

Giveaways

A battle-tested giveaway bot capable of handling hundreds of thousands of entrants

Voting for Giveaways

Do you want to support us?