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 turns grey, lists the winners and loses its button.
- Running giveaways survive a bot restart: buttons are re-attached and end timers rescheduled.
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.
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 |
/giveaway cancel giveaway_id: <id> |
Closes the giveaway without winners. The post is marked CANCELLED and a notice is sent to the channel |
/giveaway stats giveaway_id: <id> |
Status, prize, entries, winners, creation time, time left and a jump link. The ID autocompletes from recent giveaways |
/giveaway giveawayadmin |
Admin dashboard with the tabs Active Giveaways, Create, Settings and Statistics |
Creating, ending, cancelling and viewing stats requires Administrator or Manage Server, or the admin role from the settings. /giveaway giveawayadmin and /giveaway settings require Administrator.
/giveaway create-advanced is visible to everyone, but the same permission check applies.Settings
/giveaway settings default_channel: #giveaways admin_role: @Giveaway Team enabled: True require_game_id: False
Only the options you pass are changed.
| 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 overview with the tabs Active Giveaways (prize, winners, time left, entries, whether you have entered, and a jump link), My Entries and My Wins (total wins, total winnings, average prize and recent wins). Use tab to open a specific tab and public: True to post it for everyone.
Web Dashboard
Open your server in the dashboard and choose Giveaways in the sidebar (moderator role or higher). The page shows counters for active giveaways, total entries, total prizes and completed giveaways, a card per active giveaway with an End Early button, and the last 50 past giveaways with prize, winners, entries and end date.
/giveaway create to start a giveaway and /giveaway end to draw winners early; the dashboard page is for keeping an overview.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.