Giveaways

Giveaways lets managers run timed giveaways with an Enter / Exit button. When the timer runs out, Vör picks random winners, updates the giveaway post and announces the result.

Features

  • Timed giveaways with any number of winners (1-20)
  • Optional role lock: members need one of the listed roles to enter
  • Optional sponsor, description, link, image and region lock shown on the post
  • Claim window: winners are told how many hours they have to claim before a reroll
  • Subscriber role pinged whenever a new giveaway starts
  • Partial or full rerolls after a giveaway has ended
  • Buttons keep working after a bot restart

Setup

  1. Run /config cog Giveaways and make sure it is enabled.
  2. Set a Default Giveaway Channel (you can still pick another channel per giveaway).
  3. Add Manager Roles for staff who should run giveaways. Members with Manage Server can always manage them.
  4. Optionally set a Giveaway Subscriber Role to ping when a giveaway starts.

Configuration

Setting Description
Enabled Toggle the Giveaway system on or off
Default Giveaway Channel Channel giveaways are posted in when none is given
Manager Roles Roles that can create, end, reroll and list giveaways (up to 10)
Giveaway Subscriber Role Role pinged when a new giveaway starts

Commands

All commands require a Manager Role or the Manage Server permission. Replies are only visible to you.

Command Description
/giveaway create <title> <duration> [options] Create and post a giveaway
/giveaway end <giveaway_id> End an active giveaway early and draw winners now
/giveaway reroll <giveaway_id> Pick winners of an ended giveaway to replace
/giveaway list List active giveaways in this server

Prefix Commands

!giveaway end <id>, !giveaway reroll <id> and !giveaway list work the same as their slash versions.

/giveaway create options

Option Description
title Giveaway title (required)
duration How long it runs, e.g. 30m, 24h, 3d (units: s, m, h, d)
channel Channel to post in; defaults to the Default Giveaway Channel
winners Number of winners, 1-20 (default 1)
description Text shown on the post
link URL shown on the post and used as the title link
sponsor Member credited as the sponsor
roles Role IDs or mentions, comma separated. Members need one of them to enter
claim_hours Hours winners have to claim, 1-168 (default 24)
region Region lock text, e.g. UK only
image Image URL shown on the post

How It Works

Entering

Members click Enter on the giveaway post. If the giveaway is role locked and they have none of the roles, Vör tells them which roles they need. If it has a region lock, the entry confirmation reminds them of the region and that entering confirms they can receive the prize there. Clicking Enter again offers an Exit button to remove their entry.

Ending

Vör checks every 30 seconds. When a giveaway ends (on time or via /giveaway end):

  • Winners are drawn at random from the entries.
  • The original post turns grey, the buttons are removed, and the winners are listed. Sponsor, role lock, region lock and claim time stay on the ended post.
  • A congratulations message pings the winners in the giveaway channel, with a footer giving the claim time (or asking winners to DM the host if the giveaway uses manual claim).
  • If nobody entered, Vör posts that the giveaway ended with no valid entries.

Rerolling

Use a reroll when a winner doesn’t claim in time or can’t receive the prize (for example, they are outside the region lock).

  1. Run /giveaway reroll <giveaway_id>.
  2. Pick one or more winners to replace from the dropdown. Only you can use the menu.
  3. Vör draws one new winner for each person you picked, pings them with a 🎲 Reroll! message and updates the winners list on the original post.

The other winners are kept. Anyone who has already won that giveaway, including people replaced by earlier rerolls, is never drawn again. If there aren’t enough eligible entries left, Vör fills what it can and tells you how many slots stayed empty.

Important Notes

  • The giveaway ID is shown in the post footer (Giveaway ID #12) and in /giveaway list.
  • Vör can’t see where members live, so it doesn’t check the region lock itself. Check the winner’s region before sending the prize and reroll them if needed. To block entries outright, use region roles (e.g. self-assigned through Panel) as the giveaway’s roles lock.
  • Only ended giveaways can be rerolled; only active ones can be ended.
  • Giveaways can also be created from the Dashboard, which also offers the manual claim option.

Troubleshooting

“No channel specified and no default giveaway channel is configured”

Pass a channel or set a Default Giveaway Channel in /config cog Giveaways.

The giveaway was never posted

Check that Vör can see the channel and has Send Messages and Embed Links there.

“Invalid duration”

Use a number followed by one unit, e.g. 90m or 2d. Combined values like 1d12h are not supported.