Ethvex logo Ethvex Docs
Updated Invite

Giveaways

Run fair giveaways with requirements, bonus entries, rerolls and winner DMs.

System Slash Prefix % Aliases: %gw, %giveway 5s cooldown

Usage #

/giveaway <start | end | pause | resume | cancel | reroll | list>
<required> must be included[optional] can be left outDo not type the brackets

Permissions #

You need
Manage EventsManage Messages
Ethvex needs
Send Messages
Cooldown
5 seconds

Free and Pro #

Free

3 active at a time, with entry requirements and bonus entries

Pro

Unlimited active giveaways

Compare plans

Quick start #

Need a giveaway right now? Start one in a single command, without opening the panel.

OptionWhat it does
prizeWhat you are giving away. Required for a quick start.
durationHow long it runs, like 30m, 12h, 1d or 1d12h30m. If you leave it out, your saved default duration is used.
winnersHow many winners, from 1 to 50. Default 1.
channelWhere to post it. If you leave it out, your saved default channel is used, or the channel you ran the command in.

With the prefix, just type everything after start in any order you like: %gw start Discord Nitro 12h 3 #giveaways. Ethvex picks out the duration, the number of winners (after the duration) and the channel, and everything else becomes the prize.

Quick start giveaways use the defaults from your setup panel, like the colour, entry button and winner DMs, so set those up once and every quick giveaway looks right.

The setup panel #

Run /giveaway start with no options to open the setup panel. It has four tabs you can switch between with the dropdown. When everything looks right, press Launch Giveaway.

TabWhat you set
SetupPrize, duration, number of winners (1 to 50), channel, description, entry method (button or reaction) and max entries per person.
RequirementsWho can enter and who gets extra chances.
AppearanceAccent colour, banner and thumbnail images, button label, emoji and colour, reaction emoji and footer text.
ActionsWinner DMs, host DMs, pings, a winner role, a separate announcement channel and more.
Duration format

Use 30m, 12h, 1d or mix them like 1d12h30m.

Requirements and bonus entries #

Free

Entry requirements and bonus entries are free on every server.

  • Required roles. Members must have one of these roles to enter.
  • Blocked roles. Members with these roles cannot enter.
  • Minimum account age. Keeps brand new alt accounts out.
  • Minimum time in server. Rewards members who have been around a while.
  • Booster only. Only server boosters can enter.
  • Bypass roles. Members with these skip every requirement.
  • Bonus entries. Give chosen roles 2x up to 100x the chances of winning.

If someone does not meet a requirement, Ethvex tells them exactly why when they try to enter.

Actions after it ends #

  • DM each winner with a custom message, and DM the host with the results.
  • Ping winners in the channel, or suppress pings if you prefer.
  • Give winners a role automatically.
  • Announce winners in a different channel.
  • Automatically reroll if a winner cannot be picked, up to a set number of attempts.
  • Show or hide the live entry count.

Managing giveaways #

Every giveaway has a short 6 character ID. Find it with /giveaway list, then use it with the commands below.

/giveaway start

Open the setup panel for a new giveaway.

/giveaway start <prize> [duration] [winners] [channel]

Start a giveaway straight away without the panel.

/giveaway list

See active and paused giveaways with their ID, end time, winners and entries.

/giveaway end <id>

End a giveaway now and pick the winners.

/giveaway pause <id>

Freeze the timer. Nobody can enter while it is paused.

/giveaway resume <id>

Continue a paused giveaway with the time it had left.

/giveaway cancel <id>

Cancel without picking any winners.

/giveaway reroll <id> [count]

Pick new winners for an ended giveaway. Count is 1 to 50, default 1.

Message variables #

{prize}

The prize name

{host}

Mention of the host

{winners}

Number of winners

{entries}

Current number of entries

{ends}

End date and time

{ends_relative}

Time left, like "in 2 hours"

{winner}

Winner mention, in the winner DM

{server}

Server name, in the winner DM

Examples #

/giveaway start
Opens the giveaway setup panel.
/giveaway start prize:Nitro duration:1d winners:2
Starts a giveaway straight away, no panel needed.
%gw start Discord Nitro 12h 3 #giveaways
Quick start with the prefix: prize, duration, winners and channel.
/giveaway list
Shows active giveaways and their IDs.
%gw reroll 7F3A21 2
Picks 2 new winners for giveaway 7F3A21.
%gw pause 7F3A21
Freezes the timer until you resume it.