giveaways
start a giveaway, members press join, balqis picks the winners
/giveaway start: a prize, a time (30m, 2h, 1d12h, 7d), how many winners, the channel (threads and forum posts too), a sponsor and what the prize is worth. starts posts it later (premium)./giveaway quick: only the prize, the time and the winners, posted right here, with the default preset (or pick one with preset).
members press join on the post. pressing it again shows "you're in" with leave. rules shows every rule, and what they still miss.
rules: press set rules under the start reply (or /giveaway edit): must have roles, blocked roles, level, messages, hours in voice, invites, days in the server, account age, the server tag, the tag worn for days, the tag + status words. bonus roles give extra entries (they add up). balqis checks the rules at join, while it runs and again at the draw.
presets: save sets of rules and bonus roles in /giveaway settings -> presets (free 1, premium 10), then pick one with preset in /giveaway start or quick. a giveaway copies the preset when it starts.
when the time is over, balqis picks the winners fairly (more entries = more chances, one win per person). the post shows the winners, a reply pings only them, and each winner gets a dm.
claim time (off by default): the winners press claim in time, or a new winner is picked (or the staff are told). claim can open a prize ticket.
proof of prize (off by default): the winner and the staff send a picture with send proof. no winner proof in time can block them from your giveaways. /giveaway unblock takes a block away./giveaway end ends one early. /giveaway reroll picks new winners, never someone who already won it. /giveaway cancel stops it with no winners. /giveaway edit changes a running one. /giveaway entries shows who joined (with a .csv). /giveaway list shows them all.
records: every win is saved (also rerolls; a winner who does not claim in time loses it). /giveaway record add saves a win by hand: winner, prize, sponsor, value and date. the same winner again counts up. /giveaway record file brings old wins from a .csv, and /giveaway record undo takes back the newest add or file within 7 days (the server owner).
leaderboards: /top show board:lucky (most wins) and board:sponsors (most giveaways sponsored, with the total value)./giveaway settings: the winner dm, the host, the entries channel, the tag grace, the winner cooldown, the presets, the claim time, proof of prize, who sees the lucky and sponsors boards and your own designs (premium). these need the giveaways ability (in the mod preset).
the log type giveaways shows every start, change, end, reroll, claim, proof and block. pick a channel with /log add.
- 13 commands
- giveaways running at once: 3 free, 25 with premium
- bonus roles per giveaway: 1 free, 10 with premium
playground
try a giveaway
pyqa starts a giveaway with the quick defaults (level 5) and a claim time. shun is level 3, so a rule says no. atid joins, the time ends, atid wins and presses claim, and pyqa rerolls to pick one more winner.
# giveaways
balqisapptoday
pyqa /giveaway quick
nitro
ends: in 1 hour
winners: 1
entries: 0
host: @pyqa
press join to enter. the winners are picked when the time is over.
balqisapptoday
pyqa /giveaway quick
nitro
ends: in 1 hour
winners: 1
entries: 0
host: @pyqa
press join to enter. the winners are picked when the time is over.
balqisapptoday
only you can see this
you can't join yet
giveaway: nitro
you need level 5 to join · you are level 3
press [rules] on the post to see every rule.
balqisapptoday
pyqa /giveaway quick
nitro
ends: in 1 hour
winners: 1
entries: 3
host: @pyqa
press join to enter. the winners are picked when the time is over.
balqisapptoday
only you can see this
you're in · 1 entry
good luck in nitro. press [leave] if you change your mind.
balqisapptoday
pyqa /giveaway quick
nitro
ended: just now
winner: @atid
entries: 3
host: @pyqa
the winners press [claim] before in 24 hours.
balqisapptoday
pyqa /giveaway quick
nitro
ended: just now
winner: @atid
entries: 3
host: @pyqa
claimed: atid
balqisapptoday
giveaway winners
@atid won nitro.
the host @pyqa will be in touch.
balqisapptoday
only you can see this
prize claimed
you claimed nitro.
your prize ticket: #ticket-0042
balqisapptoday
pyqa /giveaway reroll
new giveaway winner
@wafi won nitro.
the host @pyqa will be in touch.
the quick defaults say level 5. press the command to start a giveaway for nitro.
run a giveaway
post it, let members join, end it early if you need to.
/giveaway startstart a giveaway: prize, time, winners, channel, sponsor and valueshow more
/giveaway start <prize> <time> [winners] [channel] [channel-id] [sponsor] [value] [dm] [cooldown] [starts] [preset]
- how
- post a giveaway with a prize, a time and winners. pick the channel, a sponsor and the value if you like. preset picks a saved set of rules. with starts it is posted later (premium).
- example
/giveaway start prize:nitro time:1d winners:2 channel:#giveaways sponsor:@shun value:rm 50- options
prizeneeded text what they can wintimeneeded text how long it runs, like 30m, 2h, 1d12h or 7dwinnersoptional number how many winners (empty: 1)channeloptional channel where to post it (empty: here). threads and forum posts toochannel-idoptional text or paste a channel or thread id (for archived threads)sponsoroptional member the member who gives the prizevalueoptional text what the prize is worth, like 50, rm 50 or sgd 10dmoptional yes or no dm the winners (empty: the server setting)cooldownoptional yes or no use the winner cooldown (empty: yes)startsoptional text post it later, like 2h or 1d (empty: now). premiumpresetoptional text use a saved rule preset (empty: no rules)
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
- balqis needs
- view channel, send messages, send messages in threads, read message history
/giveaway quickstart a giveaway here with just a prize, a time and winnersshow more
/giveaway quick <prize> <time> [winners] [preset]
- how
- the fast way: just a prize, a time and winners, posted in this channel, with the default preset (or pick one with preset).
- example
/giveaway quick prize:nitro time:2h- options
prizeneeded text what they can wintimeneeded text how long it runs, like 30m, 2h or 7dwinnersoptional number how many winners (empty: 1)presetoptional text use a saved rule preset (empty: the default preset)
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
- balqis needs
- view channel, send messages, send messages in threads, read message history
/giveaway endend a giveaway now and pick the winnersshow more
/giveaway end <giveaway>
- how
- end a running giveaway now. balqis picks the winners right away.
- example
/giveaway end giveaway:nitro- options
giveawayneeded text pick one, or paste its message id or link
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
after the end
new winners, cancelled ones and the list.
/giveaway rerollpick new winners of an ended giveaway (never the same person twice)show more
/giveaway reroll <giveaway> [count]
- how
- pick new winners of an ended giveaway. someone who already won it is never picked again.
- example
/giveaway reroll giveaway:nitro count:1- options
giveawayneeded text pick one, or paste its message id or linkcountoptional number how many new winners (empty: 1)
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
/giveaway cancelstop a running or scheduled giveaway without winnersshow more
/giveaway cancel <giveaway>
- how
- stop a running giveaway. no one wins and the post says cancelled.
- example
/giveaway cancel giveaway:nitro- options
giveawayneeded text pick one, or paste its message id or link
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
/giveaway listthe running giveaways and the ones that ended in the last 30 daysshow more
/giveaway list
- how
- see the running giveaways and the ones that ended in the last 30 days.
- example
/giveaway list- options
no options, just run it.
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
rules and entries
who may join, change a running one, see who joined.
/giveaway editchange a running giveaway: prize, winners, end, sponsor, value, rulesshow more
/giveaway edit <giveaway> [prize] [winners] [time] [sponsor] [value] [remove] [cooldown]
- how
- change the prize, the winners, the end, the sponsor or the value of a running giveaway. press set rules for its rules.
- example
/giveaway edit giveaway:nitro winners:2 time:1d- options
giveawayneeded text pick one, or paste its message id or linkprizeoptional text the new prizewinnersoptional number how many winnerstimeoptional text end it this long from now, like 2h or 1dsponsoroptional member the new sponsorvalueoptional text the new value, like 50 or rm 50removeoptional text take away the sponsor or the value pick: sponsor, value, bothcooldownoptional yes or no use the winner cooldown in this giveaway
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
/giveaway entrieswho joined a giveaway, with a .csv fileshow more
/giveaway entries <giveaway>
- how
- see who joined, 5 per page, and get a .csv with their entries.
- example
/giveaway entries giveaway:nitro- options
giveawayneeded text pick one, or paste its message id or link
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
winners extras
claim time, prize tickets, proof of prize and blocks.
/giveaway unblocktake away a proof block, so the member can enter giveaways againshow more
/giveaway unblock <member>
- how
- let a member join your giveaways again after they were blocked for sending no proof of prize.
- example
/giveaway unblock member:@wafi- options
memberneeded member the blocked member
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
records and boards
every win is saved, for the lucky and sponsors boards.
/giveaway record addsave a win by hand: winner, prize, sponsor, value, dateshow more
/giveaway record add <winner> <prize> [sponsor] [value] [date]
- how
- saves a win by hand, for a giveaway that ran without balqis: the winner, the prize, and if you want the sponsor, the value and the date (a date like 2026-11-12, or a message link). the same winner again counts up. wins of balqis giveaways are saved by themselves.
- example
/giveaway record add winner:@atid prize:nitro sponsor:@pyqa value:rm 50 date:2026-10-01- options
winnerneeded member who wonprizeneeded text what they wonsponsoroptional member the member who gave the prize (empty: no sponsor)valueoptional text what the prize was worth, like 50, rm 50 or sgd 10dateoptional text when, like 2026-11-12 or a message link (empty: now)
- who
- anyone with the giveaways ability (the mod preset and up), or the manage server permission when the server set no access rules
/giveaway record fileold wins from a .csv file (empty: see the format and an example file)show more
/giveaway record file [file]
- how
- brings old wins from a .csv: user id, prize, sponsor, value, date (only the first two are needed). a preview comes first. leave the file empty to see the format and an example file. server owner only.
- example
/giveaway record file file:old-wins.csv- options
fileoptional file a .csv: user id, prize, sponsor, value, date. up to 5,000 lines
- who
- the server owner
/giveaway record undoundo the newest record add or file (within 7 days)show more
/giveaway record undo
- how
- takes back the newest record add or file, within 7 days. wins of balqis giveaways stay. server owner only.
- example
/giveaway record undo- options
no options, just run it.
- who
- the server owner
settings
one panel with buttons.
/giveaway settingsgiveaway settings: winner dm, entries channel, tag grace, cooldown, quick rulesshow more
/giveaway settings
- how
- one panel with buttons: the winner dm, the host, the entries channel, the tag grace, the winner cooldown, the presets (saved sets of rules), the claim time (with extra time for a role or the server tag), proof of prize and your own designs.
- example
/giveaway settings- options
no options, just run it.
- who
- staff who can change the server settings
start your first giveaway
add balqis, then run /giveaway quick with a prize and a time.