Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jagrosh/GiveawayBot

🎉 Hold giveaways quickly and easily on your Discord server!
https://github.com/jagrosh/GiveawayBot

bot discord discord-bot giveaway giveawaybot giveaways java jda

Last synced: about 1 month ago
JSON representation

🎉 Hold giveaways quickly and easily on your Discord server!

Host: GitHub
URL: https://github.com/jagrosh/GiveawayBot
Owner: jagrosh
License: apache-2.0
Created: 2017-03-25T05:09:01.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2024-07-05T16:09:26.000Z (2 months ago)
Last Synced: 2024-07-05T19:36:12.383Z (2 months ago)
Topics: bot, discord, discord-bot, giveaway, giveawaybot, giveaways, java, jda
Language: Java
Homepage: https://giveawaybot.party
Size: 1010 KB
Stars: 630
Watchers: 40
Forks: 301
Open Issues: 40
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-discord - GiveawayBot - A Discord giveaway bot. (Bots / Open Source Public Bots)

README

        ## [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:


🔗 **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 \ \ \** - 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 \** - Ends a giveaway and picks the appropriate number of winners immediately

  * **/gdelete \** - Deletes the specified giveaway without picking winners

  * **/glist** - Lists currently-running giveaways on the server.

  * **/greroll \** - 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 \** - Sets the color of the embed used for giveaways

  * **/gsettings set 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

---

## Getting Support

If you need help with the bot, please join [GiveawayBot Support](https://discord.gg/giveawaybot).

## Localization

If you'd like to contribute translations, please take a look at the [messages.properties](https://github.com/jagrosh/GiveawayBot/blob/master/src/main/resources/localization/messages.properties) file, as well as other files in the [localization directory](https://github.com/jagrosh/GiveawayBot/blob/master/src/main/resources/localization). Localization files take the form `messages-locale.properties`, for example: `messages-de.properties` for German, or `messages-en-US.properties` for United States English. A list of locales is available [here](https://discord.com/developers/docs/reference#locales).

## Self-Hosting

Self-hosting your own copy of this bot is not supported nor recommended; the source code is provided here so users and other bot developers can see how the bot functions. No help will be provided for editing, compiling, or building any code in this repository, and any changes must be documented as per the [license](https://github.com/jagrosh/GiveawayBot/blob/master/LICENSE).