Skip to main content

​
Overview

The giveaway system allows you to host interactive giveaways in your server with features like role restrictions, entry multipliers, and automatic winner selection. Members react to enter, and winners are randomly selected when the giveaway ends.
Giveaways support advanced features like role-restricted entries and entry multipliers for boosters or VIP members.

​
Commands

Start a new giveaway in the current channel.
~giveaway start <duration> <winners> <prize> [role] [entry_role:entries]
Parameters:
  • duration — How long the giveaway runs (s/m/h/d/mo/y)
  • winners — Number of winners to select
  • prize — What the winners receive
  • [role] — Optional: Restrict to members with this role
  • [role:entries] — Optional: Give role holders multiple entries
Duration Format:
  • s = seconds
  • m = minutes
  • h = hours
  • d = days
  • mo = months
  • y = years
Entry Multipliers: Add @Role:number to give that role multiple entries:
  • @Booster:3 = Boosters get 3 entries each
  • @VIP:5 = VIP members get 5 entries each
Aliases: gway start, gwy start, gw start
Permissions: Manage Server
End an active giveaway early and select winners.
~giveaway end <message_link>
Parameters:
  • message_link — Link to the giveaway message
What It Does:
  • Ends the giveaway immediately
  • Selects and announces winners
  • Removes reactions
  • Cannot be reversed
How to Get Message Link: Right-click the giveaway message → Copy Message LinkAliases: gway end, gwy end, gw end
Permissions: Manage Server
Cancel an active giveaway without selecting winners.
~giveaway cancel <message_link>
Parameters:
  • message_link — Link to the giveaway message
What It Does:
  • Cancels the giveaway
  • No winners selected
  • Removes reactions
  • Deletes giveaway data
Aliases: gway cancel, gwy cancel, gw cancel
Permissions: Manage Server
Select new winners for an ended giveaway.
~giveaway reroll <message_link> [count]
Parameters:
  • message_link — Link to the ended giveaway
  • [count] — Optional: How many winners to reroll (default: all)
What It Does:
  • Selects new random winners
  • Keeps original participants
  • Updates giveaway message
  • Announces new winners
Partial Reroll: Use count to reroll only some winners:
  • reroll link 1 = Reroll 1 winner, keep others
  • reroll link = Reroll all winners
Aliases: gway reroll, gwy reroll, gw reroll
Permissions: Manage Server
Edit an active giveaway’s settings.
~giveaway edit <duration/winner/prize/entries> <value> <message_link>
Edit Options:
  • duration — Extend or shorten time
  • winner / winners — Change winner count
  • prize — Update prize description
  • entries — Set entry multipliers
  • add-entries — Add new entry roles
  • remove-entries — Remove entry roles
  • clear-entries — Remove all entry multipliers
Entry Management:
# Set entry roles (replaces all)
~gw edit entries @VIP:5 @Booster:3 <link>

# Add entry roles (keeps existing)
~gw edit add-entries @Supporter:2 <link>

# Remove entry roles
~gw edit remove-entries @VIP @Booster <link>

# Clear all entry multipliers
~gw edit clear-entries <link>
Aliases: gway edit, gwy edit, gw edit
Permissions: Manage Server
View all active giveaways in your server.
~giveaway list
What It Shows:
  • All ongoing giveaways
  • Prize for each giveaway
  • Time until each ends
  • Direct links to giveaway messages
Aliases: gway list, gwy list, gw list
Permissions: Manage Server

​
How It Works

1

Start a Giveaway

Create a giveaway with your settings:
~gw start 1d 2 Discord Nitro @Booster:3
2

Members Enter

Members react with 🎉 to enter:
  • Default: 1 entry per person
  • Boosters (in example): 3 entries each
  • Role restrictions apply if set
3

Winners Selected

When time expires (or you end it):
  • Random winners selected (weighted by entries)
  • Winners announced in channel
  • Giveaway message updated
4

Reroll if Needed

Pick new winners if needed:
~gw reroll <message_link>

​
Entry System

​
Basic Entry

Everyone gets 1 entry by default when they react.

​
Role Restrictions

Limit who can enter: 
~gw start 1d 1 Prize @Members
Only @Members can enter.

​
Entry Multipliers

Give certain roles more entries: 
~gw start 1d 1 Prize @Booster:3 @VIP:5
  • Regular members: 1 entry
  • Boosters: 3 entries
  • VIP: 5 entries

​
Combined System

Restrict AND multiply: 
~gw start 1d 1 Prize @Verified @Booster:2 @VIP:4
  • Must have @Verified to enter
  • Boosters with @Verified: 2 entries
  • VIP with @Verified: 4 entries

​
Duration Examples

# 30 minutes
~gw start 30m 1 Prize

# 1 hour
~gw start 1h 1 Prize

# 12 hours
~gw start 12h 1 Prize

# 1 day
~gw start 1d 1 Prize

# 1 week
~gw start 7d 1 Prize

​
Permission Requirements

Bot Permissions

The bot needs:
  • Send Messages
  • Embed Links
  • Add Reactions
  • Manage Messages (to remove reactions)

User Permissions

Command Requirements:
  • Manage Server — All giveaway commands
  • None — Entering giveaways (just react)

​
Aliases

All giveaway commands support multiple aliases:

giveaway

Full command

gway

Short form

gwy

Shorter form

gw

Shortest form

​
Usage Examples

# Basic giveaway
~gw start 1d 1 Discord Nitro

# Multiple winners
~gw start 12h 3 Steam Keys

# Longer duration
~gw start 7d 5 Custom Roles

​
Common Use Cases

# Give boosters more chances to win
~gw start 1d 1 Premium Role @Booster:5

# Booster-only giveaway
~gw start 12h 2 Nitro @Booster
Encourage boosting by giving advantages in giveaways.
# Celebrate 1000 members
~gw start 3d 10 Custom Roles

# Thank active members
~gw start 1d 5 Gift Cards @Active:2
Celebrate community growth with giveaways.
# Holiday giveaway
~gw start 7d 3 Holiday Prizes

# Birthday celebration
~gw start 24h 5 Birthday Prizes
Host special event giveaways.
# Multiple supporter tiers
~gw start 2d 3 Prize @Bronze:2 @Silver:3 @Gold:5 @Platinum:10

# Staff appreciation
~gw start 1d 2 Prize @Helper:2 @Mod:3 @Admin:5
Create fair but tiered entry systems.
# Wrong duration
~gw edit duration 3d <link>

# Wrong prize
~gw edit prize Corrected Prize Name <link>

# Change winner count
~gw edit winner 5 <link>

# Invalid winner
~gw reroll <link> 1
Correct errors after starting.

​
Important Notes

Winner Selection
  • Winners selected randomly
  • Entry multipliers increase chances proportionally
  • Same person can’t win multiple times
  • Winners must still have required role if restricted
Data Persistence
  • Giveaways persist through bot restarts
  • Timers automatically restart on bot reboot
  • Expired giveaways end immediately on restart
  • Backup system prevents data loss
Entry Tracking
  • Participants tracked in real-time
  • Rerolls use original participant list
  • Members who leave can’t win
  • Role changes respected during selection

Role Management

Create roles to use as giveaway prizes

Server Settings

Configure other server features