balqis

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
  • prize needed text what they can win
  • time needed text how long it runs, like 30m, 2h, 1d12h or 7d
  • winners optional number how many winners (empty: 1)
  • channel optional channel where to post it (empty: here). threads and forum posts too
  • channel-id optional text or paste a channel or thread id (for archived threads)
  • sponsor optional member the member who gives the prize
  • value optional text what the prize is worth, like 50, rm 50 or sgd 10
  • dm optional yes or no dm the winners (empty: the server setting)
  • cooldown optional yes or no use the winner cooldown (empty: yes)
  • starts optional text post it later, like 2h or 1d (empty: now). premium
  • preset optional 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
  • prize needed text what they can win
  • time needed text how long it runs, like 30m, 2h or 7d
  • winners optional number how many winners (empty: 1)
  • preset optional 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
  • giveaway needed 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
  • giveaway needed text pick one, or paste its message id or link
  • count optional 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
  • giveaway needed 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
  • giveaway needed text pick one, or paste its message id or link
  • prize optional text the new prize
  • winners optional number how many winners
  • time optional text end it this long from now, like 2h or 1d
  • sponsor optional member the new sponsor
  • value optional text the new value, like 50 or rm 50
  • remove optional text take away the sponsor or the value pick: sponsor, value, both
  • cooldown optional 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
  • giveaway needed 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
  • member needed 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
  • winner needed member who won
  • prize needed text what they won
  • sponsor optional member the member who gave the prize (empty: no sponsor)
  • value optional text what the prize was worth, like 50, rm 50 or sgd 10
  • date optional 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
  • file optional 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.

add to server