Docs · Modules
Giveaways
Run fair Discord giveaways with Based: /gwcreate, winners, rerolls, and entry requirements for roles, account age, messages, invites and server tags.
The giveaways module hosts giveaways with optional entry requirements. It is off by default. Start one with /gwcreate, giving a prize and a duration, and optionally the number of winners, the channel and requirements.
Entry requirements
- Roles: require one or more roles, or block members who have certain roles.
- Account age and membership: minimum days since the Discord account was created and minimum uninterrupted days in your server. Both are checked when a member enters and again when winners are drawn.
- Messages and invites: a minimum number of messages sent or invites made over a period such as the last 7 days. These need the activity tracking module with message or invite counting on.
- Server tag: require members to display your server's tag.
Picking winners
When a giveaway ends, Based picks winners at random from eligible entries. /gwreroll picks new winners, /gwend ends a giveaway early, /gwcancel cancels it without winners and /gwlist shows what is running. Read how fair giveaways work for what makes a draw trustworthy.
Staff and reminders
Set a giveaway manager role for members who run giveaways, a maximum duration (720 hours by default), and an optional reminder channel where Based posts a short reminder about running giveaways.
Settings
Change these in the dashboard or with /setup in Discord. They apply to one server at a time.
| Setting | Default | What it does |
|---|---|---|
| Enabled | Off | Turn this feature on for this server. |
| Giveaway manager role | Not set | Optional. Members with this role can run and manage giveaways. |
| Allowed channels | Not set | Leave empty to let Based work in every channel it can see. |
| Default winners | 1 | How many random winners a giveaway picks unless the host chooses. |
| Maximum duration | 720 | The longest a giveaway can run, in hours. |
| Default entry role | Not set | Optional. Members need this role to enter. |
| Required entry roles | Not set | Members must have every selected role to enter. |
| Blocked entry roles | Not set | Members with any selected role cannot enter. |
| Require server tag | Off | Members must display this server's primary guild tag. |
| Minimum account age (days) | 0 | Minimum age of a Discord account at entry and draw time. |
| Minimum membership (days) | 0 | Minimum uninterrupted time in this server at entry and draw time. |
| Default message requirement | 0 | Messages a member must have sent to enter. Above 0 needs Activity tracking with Count messages on. |
| Default invite requirement | 0 | Invites a member must have made to enter. Above 0 needs Activity tracking with Count invites on. |
| Activity period | 7 days | The time period those message and invite counts cover. |
| Reminder channel | Not set | Optional. Based posts a short reminder about running giveaways here, removing its previous one. |
| Reminder every (hours) | 0 | How often to post the reminder. 0 turns reminders off. |
Permissions Based needs
For this module Based's role needs: View Channel, Send Messages, Embed Links. See permissions for how to grant them only where they are needed.
Commands
Every command works as a slash command and with the text prefix (default .), so /gwcreate and .gwcreate do the same thing.
/gwcreate
Host a giveaway with eligibility requirements.
- Usage:
/gwcreate <prize> <duration> [winners] [channel] [req_messages] [req_messages_window] [req_invites] [req_invites_window] [req_role] [required_roles] [blocked_roles] [require_tag] [account_days] [member_days] prize(required): Giveaway prizeduration(required): Giveaway duration, such as 10m, 2h, or 1dwinners: Number of winners; omit to use the server's configured defaultchannel: Channel for the giveawayreq_messages: Required messages to enterreq_messages_window: Timeframe for required messagesreq_invites: Required invites to enterreq_invites_window: Timeframe for required invitesreq_role: Required role to enterrequired_roles: Required role IDs or mentions, or none to clear defaultsblocked_roles: Blocked role IDs or mentions, or none to clear defaultsrequire_tag: Require this server's displayed tagaccount_days: Minimum account age in daysmember_days: Minimum time in this server in days- Who can use it: Members with Manage Server, in servers only
/gwend
End an active giveaway.
- Usage:
/gwend [message_id] message_id: Giveaway message ID- Who can use it: Members with Manage Server, in servers only
/gwreroll
Reroll a giveaway's winners.
- Usage:
/gwreroll <message_id> [winners] message_id(required): Giveaway message IDwinners: Number of winners- Who can use it: Members with Manage Server, in servers only
/gwlist
List active giveaways for this server.
- Usage:
/gwlist - Who can use it: Anyone who can use the command, in servers only
/gwcancel
Cancel a giveaway without selecting winners.
- Usage:
/gwcancel <message_id> message_id(required): Giveaway message ID- Who can use it: Members with Manage Server, in servers only
Frequently asked questions
Can I require invites to enter a Discord giveaway?
Yes. Set req_invites on /gwcreate or a default invite requirement. Turn on activity tracking with invite counting first, which needs Manage Server.
How are winners chosen?
Randomly from members whose entries are still eligible at draw time. Account age and membership requirements are re-checked when the draw happens.
Try it in your server
Based is an AI Discord bot in 300+ servers. Every slash command also works with the "." prefix.