Giveaways Module
The giveaways module is used to create and manage venue giveaways within the server.
Giveaways are a great way to engage with your community and reward your members for their participation.
'Completed' Status
When a giveaway has ended, and winner(s) have been drawn, the activity will be marked as
Completed. This means that the giveaway is no longer active and will not be displayed
in the main menu.
Giveaways
To access the Giveaways menu, run the /admin activities command and select the button.
Giveaway Management
The Giveaways menu is used to manage all venue giveaways. It displays a count of all active giveaways and a mention of the channel where giveaways are posted.
Add Giveaway
The button will create a new giveaway with null values and redirect you to the giveaway management menu.
Modify Giveaway
The button allows you to edit giveaways that you've already created. Clicking on it will spawn a selector box with all active giveaways. Select the giveaway you'd like to modify.
Remove Giveaway
The button will delete a giveaway from the system by presenting a selector box with all active giveaways. Select the giveaway you'd like to remove.
Set Giveaway Channel
The button will prompt you to select a channel where all giveaways will be posted. This is typically a public-facing channel like #giveaways.
View Active Giveaways
The button will display a paginated list of all active giveaways currently running in the server.
Giveaway Menu
Each giveaway contains the following editable fields:
- Name - The main title for the giveaway.
- Description - A brief description of the giveaway.
- Color - An accent color to be used for the posting embed.
- Prize - The prize to be awarded to the winner.
- Num. Winners - The number of winners to be selected.
- End Date - The date and time the giveaway will end.
- Thumbnail - A flavor image to be used in the posting embed.
- Emoji - An emoji to be used on the sign-up button.
- Auto-Notify - Whether to notify the winner automatically.
Name
The main title for the giveaway - displayed at the top of the embed. If not provided, will default to Unnamed Giveaway.
Restrictions
Maximum Length: 80 characters.
Description
A brief description of the giveaway. This field is optional.
Restrictions
Maximum Length: 300 characters.
Color
An accent color to be used for the posting embed. This field is optional.
Color Picker
This must be a valid HEX color code. Please consult the Google Color Picker for assistance.
Prize
The prize to be awarded to the winner. This field is optional, but recommended.
Restrictions
Maximum Length: 50 characters.
Num. Winners
The number of winners to be selected. This field defaults to 1.
The maximum number of winners is 10.
End Date
The date and time the giveaway will end. This field is optional, but recommended.
This must be a valid date and time string not before the current date and time.
The format is MM-DD-YY HH:MM AM/PM.
Note
The end date doesn't affect the actual drawing of the giveaway and exists purely for display/informational purposes.
Thumbnail
A flavor image to be used in the posting embed. This field is optional.
Restrictions
This must be a valid image file of type PNG/APNG, JPG/JPEG, WEBP, or GIF.
Emoji
An emoji to be used on the sign-up button. If not provided, will default to 🎉.
Restrictions
This must be a valid emoji that the bot has access to use.
Auto-Notify
Whether to notify the winner automatically in DMs. This field defaults to True.
Posting the Giveaway
After completing these steps, you will have successfully created a giveaway. The next step is to click the button to post the giveaway to the default giveaway channel.
You'll see that in the #giveaways channel, the giveaway has been posted.
Rolling Winners
The final step in hosting a giveaway is to roll the winners.
This can be done by clicking the button. The bot will randomly select the number of winners specified in the Num. Winners field.
Additionally, for a quicker way to roll winners, right-click on the giveaway message, select the
Apps option, and click on the Roll Giveaway option.
If the Auto-Notify field is set to True, the bot will automatically notify the winners in DMs.
Additionally, if the server's log stream is enabled, the bot will post a log message in the log channel. This log message details the winners and also provides a text document with all user entries.
