Tutorial: Creating a Raffle
In this tutorial, we will learn how to create a raffle in the application.
Raffles are a fun way to engage with your community and reward them for their loyalty. Additionally, they can be a great way to raise funds for your venue.
Preparation
To begin, ensure that you have FroggeBot installed in your server.
What We'll Create
In this tutorial, we'll create a standard raffle for a (sadly) fictional venue called Lilypad Lounge.
The end result will look something like this:
Setting the Raffle Channel
Before you can actually create a raffle, you need to set the channel where the raffle 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 now anywhere you like simply called #raffles.
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 #raffles channel we made earlier (or your existing channel). Now all raffles will be posted in this channel by default.
Alright, let's move on to actually creating a raffle.
Creating a Raffle
To create a raffle, click on the button in the raffles menu.
You'll be presented with a 'blank' raffle status message with no data set. Let's go through each button individually and fill in all the details to give the raffle a unique and appealing identity.
Name
The name of the raffle is the first thing you'll need to set. This will generate a pop-up where you can enter the name of the raffle. We recommend using a descriptive and unique name.
For this tutorial, we'll use the name Lilypad Lounge Grand Opening Raffle.
Num. Winners
This will spawn a select menu where you can pick the number of winners for the raffle. This can be any
number between 1 and 10. There's typically only a single winner for most raffles, so let's leave it at the
default value of 1.
Winner Percentage
This will provide a pop-up where you can enter the percentage of the pot that the winner(s) of this raffle will receive. This can be any value between 0% - 100%. Venue percentage is automatically calculated.
Ticket Cost
The ticket cost is the price that users will pay per ticket to enter the raffle. This can be any value
between 1 and 999,999,999. For this tutorial, we'll set the ticket cost to a nice round 100,000.
Salary Parsing
Did you know that all large-number boxes in FroggeBot can parse salary expressions?
For example, you can enter 50k to represent 50,000 or 10m to represent 10,000,000.
Auto-Notify
This will toggle whether to automatically notify the winners when the raffle ends. This is typically a good idea.
Setting the Active Raffle
After you have entered the raffle details, there's one more step before you can begin adding tickets.
Click the button to set the raffle as the active raffle. This will allow authorized users to begin adding tickets to the raffle with the /addtickets command.
The button should now read and there should be a
mark under the Is Active field.
Posting the Raffle
After completing these steps, you will have successfully created a raffle. The next optional step is to click the button that will post the raffle in the channel you set earlier. This will create a tracking message so that users can see the raffle details and pot value.
Click the button to do that now.
You'll note that in the #raffles channel, the raffle has been posted.
Now let's check out how to add tickets an active raffle.
Adding Tickets
To add tickets to the active raffle, you can use the /addtickets slash command.
Enter the discord user who bought the tickets and the number of tickets they purchased.
Rolling a Raffle
To roll a concluded raffle, begin by calling up the raffle menu (using the initial steps above).
Click the button.
This will automatically roll the raffle and select the winner(s) for you.
After the raffle has been rolled, the bot will update the original message in the #raffleschannel 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
raffle 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 raffle in the application.