Giveaways
Staff post a giveaway with a prize, an end time and a number of winners. Members press Enter on the message, and when the time is up kesarAI draws the winners, announces them and sends each a DM. Giveaways are off until you turn them on, on the dashboard.
Starting a giveaway
/giveaway start takes the prize, how long it runs (5 minutes to 60 days, like 2d12h) and how many winners (1 to 20). You can also pick the channel, a role members need, a number of messages to send after it starts, and a role to ping above it. The server owner, admins (Manage Server or Administrator) and roles with the giveaways mod permission can run it.
The dashboard’s Giveaways page has everything else: the full list of requirements, bonus entries, the message’s title, text, image and colour, saving a draft, and scheduling a start up to 90 days ahead. Creating and editing on the dashboard is for server admins.
- A server can have up to 10 running or scheduled giveaways at a time.
- A giveaway is posted in a text channel, not a thread. kesarAI needs View Channel, Send Messages, Embed Links and Read Message History there.
- Pinging @everyone, or a role that isn’t mentionable, needs your own Mention Everyone permission.
- The message’s image is checked by Autopilot before it is posted.
Entering
The giveaway message has one button, Enter, with the number of entries on it. Press it and kesarAI answers only to you: either “You’re in” with anything still to do before the draw, or a checklist of what you’re missing. Once you’re in, that answer has a Leave giveaway button. Press Enter again any time to see where you stand.
The message always shows two numbers, for example “42 entries · 31 currently eligible”: how many members entered, and how many of them meet every requirement right now. Bots can’t enter, and the host can’t win unless “The host can win” is on.
Requirements and bonus entries
A giveaway can have up to eight requirements, and a member has to meet all of them. There are two kinds.
- To enter: having one of some roles, not having a role, a level, a number of messages in the last 7, 30 or 90 days, time in the server, joining before the giveaway started (on by default), and account age. A member who misses one can’t enter yet.
- By the draw: sending a number of messages, or earning an amount of XP, after the giveaway started. Members can enter straight away; these are checked when the winners are drawn.
Bonus entries give members with a chosen role more chances: 2× up to 11× entries per rule, up to five rules. A member who matches several rules gets the largest one, not the sum. Messages are counted from kesarAI’s own activity record, so messages that were later purged still count, and a /say post counts for its sender.
While a giveaway is running you can change its text, prize, number of winners, end time and bonus entries. Requirements can only be loosened or removed, because members already entered under the posted rules.
The draw
At the end time kesarAI draws at random from the entries that meet every requirement at that moment, using the bonus entries as weights. Nobody can win the same giveaway twice. Members who left the server, hold a blocked role or are inside the server’s win cooldown are skipped.
The message changes to show the winners, kesarAI replies to it with a ping for each winner, and each winner gets a DM (unless “DM the winners” is off). If fewer members are eligible than there are prizes, everyone eligible wins; if nobody is, the reply says nobody won. A giveaway whose end time passed while kesarAI was offline is drawn as soon as it is back.
The audit log entry says how many entries were skipped and why. It also marks winners whose account is under 30 days old, who joined under 7 days ago, or who have under 5 counted messages. Nothing is blocked for those; it is there for staff to look at.
Ending early, rerolls and cancelling
/giveaway endends a running giveaway now and draws the winners./giveaway rerollpicks new winners for an ended giveaway, either for one winner you name or for all of them. The new winners come from the entries that are still eligible and never include someone who already won it. If nobody else is eligible, the winners stay as they are./giveaway cancelcancels a giveaway without drawing. Deleting the giveaway message or its channel cancels it too./giveaway listshows the running and scheduled giveaways.
Setup
On the dashboard’s Giveaways page, open the settings and turn giveaways on. The settings also hold the defaults for new giveaways: the channel, a role to ping, whether winners get a DM, whether only members who joined before the start can win, bonus entries, blocked roles, and a win cooldown (how many days a winner waits before they can win again). Members with the jail or quarantine role can never enter. Server admins change the settings; moderators with the AI tier can see the list.
Entries of a finished giveaway are deleted after 30 days. /privacy forget removes your entries in finished giveaways; the list of winners is kept.
