Medusa/modules/Giveaways

Giveaways

Button-entry giveaways with entry requirements, automatic draws and rerolls.

Members enter a giveaway with one button. The button shows the entry count, and pressing it again leaves the giveaway. When the timer ends, Medusa draws the winners and announces them.

Starting a Giveaway

/giveaway start prize:Nitro duration:3d winners:2

Durations use minutes, hours, days or weeks, such as 30m, 2h, 3d or 1w. An unreadable duration falls back to one hour. Without winners one winner is drawn, and without channel the giveaway posts in the current channel.

Requirements

A giveaway can require any of these to enter:

OptionRequirement
roleThe member must have the role.
levelThe member must be at least this level. Needs the Leveling module.
invitesThe member must have at least this many invites. Needs the Invites module.

A level or invites requirement is skipped when its module is not installed.

Settings

SettingDefaultWhat it does
Entry Button EmojiPartyEmoji on the entry button.
Giveaway Ping RoleNoneRole mentioned when a giveaway starts.

Commands

CommandWhat it does
/giveaway start <prize> <duration> [winners] [channel] [role] [level] [invites]Start a giveaway.
/giveaway end <id>End a giveaway now and draw the winners.
/giveaway reroll <id> [count]Draw new winners for an ended giveaway.
/giveaway list [status]List active or ended giveaways.
Reroll GiveawayRight-click a giveaway message, then Apps > Reroll Giveaway. Off by default on the Commands page.

These commands belong to the Admin rank by default. The Giveaways dashboard page lists every giveaway with its entries and winners, and the Giveaway Events log records starts, ends and rerolls.