Skip to main content
Documentation

Module · FREE

Giveaways

Multi-winner draws with end-time auto-pick, manual force-end and reroll. The schema reserves one optional requirementType/requirementValue pair (e.g. a minimum role) but the dashboard form currently exposes only prize / duration / winners / channel. Manage at /dashboard/[guildId]/giveaways.

Capabilities

Verified in apps/bot-engine/src/bot/commands/giveaway/index.js :

Multi-winner

Up to 20 winners per giveaway (the SlashCommandBuilder caps with .setMaxValue(20)).

Duration

From 1 minute to 10 080 minutes (= 7 days).

Reroll

Re-draw winners from past entries (in case prize wasn't claimed).

List + early end

Staff can list all active giveaways or end one early via /giveaway end <message_id>.

The Discord slash interface takes prize, duration and winners only. A single optional requirement (e.g. a role gate) is reserved in the schema for future UI exposure.

Creator gift codes vs giveaways

For sponsoring drops, viewer milestones or stream rewards, use Creator Gift Codes instead — they're claimable via /redeem and configurable at /dashboard/[guildId]/gift-codes. Reward types and per-code redemption caps are configured in the dashboard.

Slash commands

/giveaway startStart a new giveaway (prize + duration in minutes + winners count).
/giveaway endEnd a giveaway early (give the message ID).
/giveaway rerollReroll winners for an ended giveaway.
/giveaway listList all active giveaways.
/redeemRedeem a creator gift code for a reward (separate gift-code system).

See plan limits for max active giveaways + max winners per draw.

Beta