GiveawayBot helps you hold giveaways quickly and easily on your Discord server!

## [GiveawayBot](https://giveawaybot.party)
[![Stars](https://img.shields.io/github/stars/jagrosh/GiveawayBot.svg)](https://github.com/jagrosh/GiveawayBot/stargazers)
[![GuildCount](https://img.shields.io/badge/dynamic/json.svg?label=servers&url=https%3A%2F%2Fdiscord.bots.gg%2Fapi%2Fv1%2Fbots%2F294882584201003009&query=%24.guildCount&colorB=7289DA)](https://discord.bots.gg/bots/294882584201003009)
[![Patreon](https://img.shields.io/badge/donate-Patreon-orange.svg)](https://www.patreon.com/discordgiveaways)
[![CodeFactor](https://www.codefactor.io/repository/github/jagrosh/giveawaybot/badge)](https://www.codefactor.io/repository/github/jagrosh/giveawaybot)  
[![PrivacyPolicy](https://img.shields.io/badge/Privacy%20Policy--lightgrey.svg?style=social)](https://gist.github.com/jagrosh/f1df4441f94ca06274fa78db7cc3c526#privacy-policy)
[![License](https://img.shields.io/github/license/jagrosh/GiveawayBot.svg)](https://github.com/jagrosh/GiveawayBot/blob/master/LICENSE)
[![ObjectDB](https://img.shields.io/badge/database-ObjectDB-556699)](https://www.objectdb.com/)
[![Discord](https://discordapp.com/api/guilds/585687812548853760/widget.png)](https://discordapp.com/invite/Q5wxTJF)


Hold giveaways quickly and easily on your Discord server! GiveawayBot is powered by [DiscordInteractions](https://github.com/jagrosh/DiscordInteractions) and [ObjectDB](https://www.objectdb.com/).

## Invite
If you'd like to add **GiveawayBot** to your server, use the following link:<br>
🔗 **https://giveawaybot.party/invite**

## Usage
### Commands  
  * **/ghelp** - Shows the available commands
  * **/gabout** - Shows information about the bot
  * **/ginvite** - Shows a link to add the bot to your server
  * **/gcreate** - Interactive giveaway setup
  * **/gstart \<time> \<winners> \<prize>** - Starts a new giveaway in the current channel. Users can click the button to enter the giveaway. The time can be in seconds, minutes, hours, or days. Specify the time unit with an "s", "m", "h", or "d", for example `30s` or `2h`.
  * **/gend \<giveaway_id>** - Ends a giveaway and picks the appropriate number of winners immediately
  * **/gdelete \<giveaway_id>** - Deletes the specified giveaway without picking winners
  * **/glist** - Lists currently-running giveaways on the server.
  * **/greroll \<giveaway_id>** - Picks a new winner from the specified giveaway. You can also right-click (or long-press on mobile) on an ended giveaway and select Apps > Reroll Giveaway to reroll.
  * **/gsettings show** - Shows GiveawayBot's settings on the server. Some settings are set automatically, such as locale.
  * **/gsettings set color \<hex_code>** - Sets the color of the embed used for giveaways
  * **/gsettings set emoji \<emoji>** - Sets the emoji or text used on the button to enter giveaways

### Buttons  
  * Press the button on an active giveaway to enter the giveaway
  * Press the giveaway summary button on an ended giveaway to view a summary of a giveaway