Giveaways
Giveaways with an entry button, role requirements, automatic drawing and reroll.
In the panel under: Community, Giveaways
You start a giveaway with a command, members enter with a button, and the bot draws the winners automatically when it ends. Rerolling and ending early work too.
Settings in the panel
| Setting | Meaning |
|---|---|
| Default Color | Color for giveaway embeds, unless a single giveaway sets something else |
| Default Thumbnail URL | Image at the top right of the embed |
| Notify winners via DM | Every winner gets a DM with the prize, the server name and a link to the giveaway |
| Log Channel | New and ended giveaways are logged here |
Commands
| Command | Effect |
|---|---|
/gcreate |
Start a new giveaway |
/gend |
End early and draw right away |
/greroll |
Draw new winners |
/gcancel |
Cancel without drawing, optionally with a reason |
/glist |
Show active giveaways |
With /gcreate you can set, among other things:
- rolle required roles, several separated by spaces or commas. Only members with one of them can enter
- notallowed excluded roles
/gend, /greroll and /gcancel expect the Message ID of the giveaway. You get it by right clicking the message when Developer Mode is on in Discord.
The three messages
You design all three in the Message Builder on the same page:
| Message | What it is |
|---|---|
| Panel | The giveaway itself with the entry button |
| Winner announcement | The reply below the giveaway when it ends or is rerolled |
| Winner DM | The direct message to every winner |
The entry button in the panel is a required element and always stays.
Variables
Panel: {prize}, {description}, {winners}, {endAt}, {host}, {participants}, {requiredRoles}, {excludedRoles}, {guild}, {memberCount}
Winner announcement: {prize}, {winners}, {host}, {messageUrl}, {guild}
Winner DM: {prize}, {messageUrl}, {guild}
A restart does not end a giveaway
If a giveaway ends while the bot is restarting, it is caught up afterwards. The bot keeps a list of servers with running giveaways and checks them regularly. On top of that, a full pass over all servers runs less often as a safety net.
Color
The color of a single giveaway can stay empty. Then the Default Color from the panel applies.
Required permissions
Send Messages, Embed Links, Manage Messages.