Skip to main content
The Giveaways module allows you to easily host and manage server giveaways. ZEON automatically handles the countdown, tracks reactions, and randomly selects the winners when the timer ends.
Required Permission: Administrator — Only users with the Administrator permission can host and manage giveaways.

​
Hosting a Giveaway

To start a new giveaway, use the .gcreate command. You must provide the duration, number of winners, and the prize. 
.gcreate <duration> <winners> <prize> [banner_url]
Parameters:
  • <duration>: How long the giveaway lasts (e.g., 10m, 12h, 1d, 1d 12h).
  • <winners>: The number of winners to select (must be at least 1).
  • <prize>: The name of the prize you are giving away.
  • [banner_url] (Optional): A direct link to an image (HTTP/HTTPS). You can also simply attach an image to your command message, and ZEON will automatically use it as the banner.

​
Example

.gcreate 12h 3 Discord Nitro Classic
This starts a 12-hour giveaway for 3 winners, with the prize “Discord Nitro Classic”.
The giveaway embed automatically matches the dominant color of your server icon!

​
Managing Giveaways

You can manage your active and ended giveaways using message replies, Message IDs, or Message Links. Only the Host of the giveaway can use these management commands.
CommandDescription
.gend <message>Ends an active giveaway immediately, selecting winners right now.
.greroll [count] <message>Re-rolls the winners for an ended giveaway. You can optionally specify a new winner count.
.glistDisplays a dashboard of all active giveaways in the server.
.gdelete <message>Completely deletes a giveaway from the database and removes the message.

​
Reroll Examples

If you just want to draw new winners based on the original count, you only need to provide the message reference. If you want to change how many winners are selected during the reroll, provide the new count first.
Same Winner Count
.greroll 123456789012345678
Change Winner Count
.greroll 5 123456789012345678
The command above forces the ended giveaway to redraw with 5 winners instead of the original amount.

​
How to reference the <message>:

For the management commands above, you can specify the target giveaway in three ways:
  1. Reply: Simply reply to the giveaway message with the command (e.g., reply with .gend).
  2. Message ID: Paste the Message ID (e.g., .gend 123456789012345678).
  3. Message Link: Paste the full Discord Message Link.

​
Limits

  • Each server can have a maximum of 5 active giveaways at the same time.
  • Only the user who hosted the giveaway (the Host) can end, reroll, or delete it.
  • Giveaway data is automatically cleaned up and deleted 3 days after the giveaway ends.