Skip to main content
Percy’s giveaway feature lets you host transparent, automated contests in your server. You set a prize, a deadline, and how many winners to draw — Percy handles the rest. When the timer ends, winners are chosen at random from everyone who entered and announced in the channel.

​
How Giveaways Work

When you create a giveaway, Percy posts an embed in the target channel with an Enter button. Members click the button to add themselves to the entry pool. Each member can only enter once. When the giveaway ends — either by timer or manually — Percy randomly selects the configured number of winners from the pool, mentions them in a reply, and updates the embed to show the final results. If eligible entries remain after the draw, a Reroll button appears so the creator can pick a fresh set of winners without running a new giveaway.

​
Commands

Both commands require Ban Members or Manage Messages.

​
Creation Flags

​
Examples

​
Running a Giveaway Step by Step

1

Create the giveaway

Run /giveaway create with a duration, a prize name, and any optional flags. Percy posts the giveaway embed immediately with the Enter button active.
2

Members enter

Anyone who wants to win clicks the Enter button. Percy confirms their entry with an ephemeral message and updates the entry count on the embed.
3

Winners are drawn

When the timer expires, Percy randomly selects winners from the entry pool, mentions them in a reply to the giveaway message, and locks the embed to show the final state.
4

Reroll if needed

If the draw needs to be repeated — for example, if a winner is unavailable — the giveaway creator can click the Reroll button that appears after the giveaway ends. Rerolling picks a new random winner from the remaining entries.

​
After the Giveaway Ends

Once Percy draws winners:
  • The original embed updates to show winner names, the final entry count, and the end time.
  • A reply is posted in the same channel mentioning each winner.
  • If entries remain in the pool, a Reroll button appears on the winner announcement. Only the creator of the giveaway can use it.
  • Members who have left the server are automatically excluded from the winner pool — their slots roll over to other valid entrants.
Percy must have Send Messages and Embed Links permissions in the target channel. If you use --channel, make sure Percy has access to that channel before creating the giveaway.
Use --description to communicate entry requirements clearly, such as “Must be a server member for at least 7 days” or “Reaction roles must be set before entering.” This text appears directly on the giveaway embed where everyone can see it.