Giveaways: Prize Draws with Conditions, Bonus Entries and Rerolls

With giveaways you run prize draws on your server: Kage posts a message with a Join button, collects the entries, draws winners automatically at the end, and can give them a role or send a direct message. You set conditions, such as a required role, a minimum account age or bonus entries for certain roles.

For a short walkthrough, see the guide Setting up giveaways.

Requirements

• Permissions: The /giveaway command can only be used with Manage Server. In the dashboard you need the same permission (or access granted for this module).
• Kage's permissions in the channel: Send Messages, Embed Links and, for the winner role, Manage Roles with a role above the winner role.
• Limit on running giveaways: The plan limits how many giveaways may run at once: Premium up to 10, Enterprise up to 50. Ending a giveaway frees up space again.

Starting a giveaway

You can start a giveaway by command or in the dashboard under Giveaways → New giveaway. The fields are the same:

Kage posts an embed with prize, number of winners, number of entrants, optional sponsor and image, and the end as date and relative time. Below is the "Join 🎉" button. You receive the giveaway ID and a link.

Entering

A member clicks Join. Kage checks in order:

1. Is the giveaway still running?
2. Does the member have the required role?
3. Do they carry an excluded role?
4. Is their Discord account old enough?
5. Have they been on the server long enough?

If they pass all checks, Kage registers them. Each person has one entry; a second click reports "you're already entered". The entrant count in the embed updates after every new entry. If a condition is not met, the member receives a private message saying why.

If the giveaway has a bonus role, members with that role count with the configured number of entries, everyone else with one entry. If someone has several bonus roles, the highest number applies.

The draw and the end

Kage checks every 30 seconds whether a giveaway has expired.

1. Kage draws the winners weighted and without replacement: whoever has more entries is more likely to win, but each person can win only once.
2. Kage updates the message: the button disappears, the embed shows the winners (or that there were no entries) and the footer "Giveaway ended".
3. Kage posts a congratulation in the channel mentioning the winners, or reports that nobody entered.
4. If a winner role is chosen, Kage gives it to the winners. If the notify by DM option is on, Kage also sends a direct message.
5. The end appears in the module's Logs tab.

Kage always marks a giveaway as ended, even if something goes wrong (for example a deleted channel), so that it is not retried endlessly.

Commands

The /giveaway group can only be used with Manage Server. Only you see the replies, except for the reroll.

On a reroll, Kage excludes the previous winners and draws among the remaining entrants with the same weights. If nobody is left, Kage reports that. A reroll is not possible for a giveaway that is still running.

Ending and rerolling exist only as commands. In the dashboard you start and watch giveaways.

In the dashboard

Under Giveaways you see Active and Completed giveaways (the most recently completed) with prize, number of winners and entrants, conditions, bonus roles, sponsor and winner role.

Settings at a glance

Giveaways have no module settings: you define everything per giveaway at the start. The dashboard page starts them through the New giveaway form.

Checking the result

1. Start: Start a test giveaway with a runtime of 1 minute. The embed appears with the Join button.
2. Entering: Click Join with a test account. The entrant count rises to 1.
3. End: At most about 30 seconds after expiry, the congratulation appears in the channel.
4. Reroll: /giveaway reroll draws if there are further entrants.

Troubleshooting

The Join button does not respond

The giveaway has ended or is no longer active. The button then shows a corresponding message. The button keeps working after a bot restart.

A member cannot enter

They lack the required role, carry an excluded role, their account or server membership is too young, or they are already in. The private message names the reason.

The giveaway cannot be started

Check Kage's permissions in the channel (Send Messages, Embed Links). Check whether the limit of running giveaways has been reached, and whether the image URL starts with http:// or https://.

No draw after expiry

The draw follows within about 30 seconds. If Kage was offline, it catches up as soon as it runs again.

The winner role is not assigned

Kage's role is below the winner role in the role list, or it lacks Manage Roles. Kage does not report this error; the congratulation in the channel appears anyway. In that case, grant the role by hand.

The DM does not arrive

The winner has blocked direct messages from server members. Kage silently skips the DM. The congratulation in the channel appears anyway.

Further reading

Polls: Polls. Roles with conditions: Role Panels.