Contents
Levlix Giveaway Module Guide
The Levlix Giveaway Module lets admins post timed giveaways that pay out server points. Members enter with one click and winners are drawn automatically.
See also: Giveaway Automation.
How a Giveaway Works
- An admin sets a title, point prize, number of winners and duration. Levlix posts the giveaway in the chosen channel with an Enter Giveaway button.
- Members click the button to enter. Each member can enter once, and the entry counter on the post updates after every entry.
- When the timer runs out, Levlix picks the winners at random, credits the prize to each winner's balance and posts a winner announcement in the same channel. The original post shows the outcome and loses its button.
- The giveaway post and the winner announcement are cards in the server language. The In my language button shows the same card in your own language, visible only to you.
- Running giveaways survive a bot restart: buttons are re-attached and end timers rescheduled. A giveaway whose end time passed while the bot was offline is drawn as soon as the bot is back.
Creating a Giveaway
/giveaway create channel: #giveaways
The channel is optional; without it Levlix uses the default channel from the settings, or the current channel. The command opens a form:
| Field | Description |
|---|---|
| Giveaway Title | Headline of the post, up to 255 characters |
| Description | Optional text, up to 1000 characters. Defaults to "Good luck to all participants!" |
| Points Prize | Points credited to each winner. Must be a positive number |
| Number of Winners | Between 1 and 20 (default 1) |
| Duration | 60m, 1h, 1d, 2d12h and similar. A plain number counts as minutes. Default 60m |
/giveaway create-advanced opens the same form with an extra require_game_id option that overrides the server default for this giveaway: only members with a registered Game ID can enter.
From the Web Dashboard
On the Giveaways page, click New Giveaway and fill in Title, Description, Points Prize, Winners, Channel and Duration (Hours). Require Game ID limits entries to members with a registered Game ID. Create Giveaway hands the giveaway to the bot, which posts it in the channel exactly like /giveaway create: same post, same Enter Giveaway button, same automatic draw and payout.
The limits match the command: up to 20 winners and 1 to 720 hours. You need permission to send messages in the channel, and so does the bot.
Managing Giveaways
Every giveaway post shows its ID in the footer; the admin commands use it:
| Command | Description |
|---|---|
/giveaway end giveaway_id: <id> |
Ends the giveaway now, draws the winners and pays the prize. End Early on the dashboard does the same |
/giveaway cancel giveaway_id: <id> |
Closes the giveaway without winners. The post is marked CANCELLED and a notice is sent to the channel. Cancel on the dashboard does the same |
/giveaway stats giveaway_id: <id> |
Status, prize, entries, winners, creation time, time left and a jump link. The ID autocompletes from recent giveaways. Without giveaway_id you get an overview of the server's giveaways |
Creating, ending, cancelling and viewing stats requires Manage Server (or Administrator), or the admin role from the settings. /giveaway settings requires Manage Server.
Settings
/giveaway settings default_channel: #giveaways admin_role: @Giveaway Team enabled: True require_game_id: False
Only the options you pass are changed. Without options the command shows the current settings. The same settings are also in /setup under Engagement and then Giveaways, and in the Settings card of the dashboard's Giveaways page.
| Option | Description |
|---|---|
default_channel |
Channel used when /giveaway create is run without a channel |
admin_role |
Role allowed to create and manage giveaways besides Administrator and Manage Server |
enabled |
Turns giveaway creation on or off. When off, the create commands answer "Giveaways are currently disabled on this server." |
require_game_id |
Server-wide default: only members with a registered Game ID can enter |
For Members
/giveaway prizes
Opens a private hub with three tabs:
| Tab | Description |
|---|---|
| Running | Every running giveaway with its prize, end time and entries. Enter joins a giveaway straight from the hub |
| My entries | The running giveaways you have entered |
| My wins | How many giveaways and points you have won, with your recent wins |
The hub is only visible to you.
Web Dashboard
Open your server in the dashboard and choose Engagement → Giveaways in the sidebar (moderator role or higher). The page shows counters for active giveaways, total entries, total prizes and completed giveaways, a Settings card (Giveaways enabled, Require Game ID, Default channel and Giveaway admin role, the same settings as /giveaway settings), a card per active giveaway with Cancel and End Early buttons, and the last 50 past giveaways with prize, winners, entries and end date.
New Giveaway starts a giveaway (see From the Web Dashboard). End Early asks for confirmation, then the bot draws the winners, pays the prize and announces them in the giveaway channel, just like /giveaway end. Cancel closes the giveaway without winners, just like /giveaway cancel.
FAQ
What if there are fewer entries than winners? Levlix draws as many winners as there are entries. With no entries, it announces that there were not enough participants.
Can a member enter twice? No. A second click answers "You have already entered this giveaway!" Entries are also refused once the end time has passed.
Can giveaways run in DMs? No. Giveaways only work in servers.