Tutorial: Creating a Giveaway
In this tutorial, we will learn how to create a giveaway in the application.
Giveaways are a fun way to engage with your community and reward them for their loyalty. You can give away anything from in-game items to real-life merchandise.
Preparation
To begin, ensure that you have FroggeBot installed in your server.
What We'll Create
In this tutorial, we'll create a giveaway for a (sadly) fictional venue called Lilypad Lounge. The end
result will look something like this:
Setting the Giveaway Channel
Before you can actually create a giveaway, you need to set the channel where all giveaways will take place. Most venues typically have a channel like this already set up, but if you don't, let's create a new one in a public-facing area called #giveaways.
Next we'll use the /admin activities command in a private channel.
This will open the activities module main menu.
Click on the button to get started.
Next click on the button.
Enter a mention for the #giveaways channel we made earlier (or your existing channel).
Now all posted giveaways will be posted in this channel by default. Now we can move on to actually creating a giveaway.
Creating a Giveaway
To create a giveaway, click on the button in the giveaways menu.
You'll be presented with a 'blank' giveaway status message with no data set. Let's fill in some details.
Name
This will provide a pop-up where you can enter the name of the giveaway. We recommend using a descriptive and unique name.
Description
This will provide a pop-up where you can enter a description of the giveaway. This is a good place to describe what the giveaway is for and if there are any miscellaneous details.
Accent Color
This will provide a pop-up where you can provide an accent color for the giveaway embed. This is purely aesthetic and can be any color you like.
Color Picker
This must be a valid HEX color code. Please consult the Google Color Picker for assistance.
Prize
This will provide a pop-up where you can enter the prize for the giveaway. This is what the winner will receive.
Thumbnail
This will provide an opportunity to enter a thumbnail image for the giveaway. This is optional but can be used to make the giveaway more visually appealing.
Button Emoji
This will let you enter an emoji that will be displayed on the giveaway's entry button. This is optional but can be used to make the giveaway more visually appealing.
End Date
This will provide a pop-up where you can enter the end date for the giveaway. Please ensure that this is in a valid date format.
Num. Winners
This will provide a pop-up where you can enter the number of winners for the giveaway. This can be any number you like, but typically is 1.
Auto-Notify
This will toggle whether to automatically notify the winners when the giveaway ends. This is typically a good idea.
Posting the Giveaway
After completing these steps, you will have successfully created a giveaway. The final step, is to click the button that will post the giveaway in the channel you set earlier.
You'll see that in the #giveaways channel, the giveaway has been posted.
Now let's check out how to roll a completed giveaway.
Rolling a Giveaway
The quickest way to roll a completed giveaway is to right-click the giveaway message and select the
Roll Giveaway option from the Apps context menu.
This will automatically roll the giveaway and select the winner(s) for you.
Rolling Early
The End Date field for the giveaway is not enforced, so you can roll a giveaway early if you like.
Should you decide to do this, the bot will confirm your decision before proceeding.
After the giveaway has been rolled, the bot will update the original message in the #giveaways channel to state the winner(s) and will remove the entry button to prevent further signups.
Additionally, if the Auto-Notify option was enabled, the winners will be notified in their DMs.
Log Data
Finally, if you've set a global Log Stream channel for your server
(recommended), the bot will log the
giveaway roll data there along with a plain text file of all entries for your records.
And there you have it! You've successfully created and rolled a giveaway in the application.