balqis

vanity and perk roles

roles for the tag, boosting or status words, and the booster's own role

vanity roles: /perks vanity add gives a role to members who wear the server tag, boost, or have words in their custom status (two together = both are needed). a member who stops loses the role after a wait (/perks vanity wait). being offline never takes a status role. /greet vanity set has the tag thanks and the status thanks.
perk roles: a member who qualifies makes one custom role of their own (a name and a color) on the perk panel (/perks role send). /perks role settings picks who qualifies (boosters after some months, a number of boosts, unlock roles, or only by hand), the divider every perk role goes under, the most roles and the wait between changes. the role has no permissions. when the perk ends, the role is deleted 3 days later (qualify again before then to keep it). months come from discord's "boosting since", which starts again after a break; boosts are the boosts balqis has seen (staff fix a count with /greet boost set).
sharing: turn it on with sharing in /perks role settings. boosters give their role to 1 to 10 friends with share my role; the friend accepts in a dm. friends lose it when the perk ends. sharing is off by default. staff turn it on in /perks role settings.
/perks role give, take, link, reset and list are for staff.
tip: balqis reads custom statuses only in a server with a status rule, and never saves them.

  • 13 commands
  • perk roles: 50 free, 200 with premium

playground

thank your boosters

give boosters a role, post the perk panel, let pyqa make a role of their own and share it with a friend.

# staff

balqisapptoday

shun /perks vanity add

vanity rule added

trigger: boosting

role: @booster

balqis checks your members now and gives the role to everyone who matches. when a member stops, the role is taken off after the wait: 10 minutes.

# perks

pyqa just boosted the server!

balqisapptoday

shun /perks role send

make your own role

a thank you for supporting the server: make one custom role of your own, with your own name and color.

who can: members who boost this server

rules: no rude words, no staff names, and not the color of a staff role. when the perk ends, your role is deleted 3 days later.

balqisapptoday

only you can see this

your new role

colors: lilac

pick a color from the menu, or type your own hex. then press save.

night owl a pretend role.

balqisapptoday

only you can see this

your role is ready

you have it now. it stays while you qualify. press make my role again to change it.

night owl a pretend role.

@ balqis

balqisapptoday

a booster wants to share their role

press accept to wear the same role in this server, or no thanks. you can wear one shared role at a time.

night owl a pretend role.

balqisapptoday

you have the shared role

you wear this role now. press leave role any time to take it off.

night owl a pretend role.

staff give boosters a role. press the command.

vanity roles

a role for the server tag, boosting or status words.

/perks vanity addgive a role to members who wear the server tag, boost or have words in their statusshow more

/perks vanity add <trigger> <role> [words]

how
gives a role to members who wear the server tag, boost, or have words in their custom status. pick a trigger (two together mean both are needed). a member who stops loses the role after a wait. balqis reads statuses only for this and never saves them.
example
/perks vanity add trigger:boosting role:@booster
options
  • trigger needed text what the member must do pick: server tag, boosting, status words, tag + boosting, tag + status words
  • role needed role the vanity role
  • words optional text status words or links, up to 3, split by commas
who
staff who can change the server settings
balqis needs
manage roles
/perks vanity listshow the vanity rules, who has each role, the wait and the blocked membersshow more

/perks vanity list

how
the vanity rules, who has each role, the wait and the blocked members.
example
/perks vanity list
options

no options, just run it.

who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules
/perks vanity removeremove a vanity rule (balqis takes its role from the members who got it)show more

/perks vanity remove <rule>

how
removes a vanity rule. balqis takes its role from the members who got it.
example
/perks vanity remove rule:1
options
  • rule needed text the rule to remove
who
staff who can change the server settings
balqis needs
manage roles
/perks vanity waithow long a vanity role stays after the member stops wearing the tag or wordsshow more

/perks vanity wait <minutes>

how
how long a vanity role stays after a member stops wearing the tag or the words: no wait, 10, 30 or 60 minutes (10 by default). being offline never takes a status role.
example
/perks vanity wait minutes:10 minutes
options
  • minutes needed text the wait pick: no wait, 10 minutes, 30 minutes, 60 minutes
who
staff who can change the server settings
/perks vanity blockstop balqis from giving or taking vanity roles for one membershow more

/perks vanity block <member> [reason]

how
stops balqis from giving or taking vanity roles for one member.
example
/perks vanity block member:@wafi reason:testing
options
  • member needed member the member
  • reason optional text why (default: no reason given)
who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules
/perks vanity unblocklet balqis give vanity roles to a blocked member againshow more

/perks vanity unblock <member>

how
lets balqis give vanity roles to a blocked member again.
example
/perks vanity unblock member:@wafi
options
  • member needed member the member
who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules

the perk panel

members make one custom role of their own.

/perks role sendpost the perk panel where members make their own roleshow more

/perks role send [channel] [channel-id]

how
posts the perk panel where members make their own role: a name and a color. a member who qualifies presses make my role.
example
/perks role send channel:#perks
options
  • channel optional channel where the panel goes
  • channel-id optional text or paste a channel or thread id (for archived threads)
who
staff who can change the server settings
balqis needs
view channel, send messages, send messages in threads, embed links
/perks role settingswho can make a perk role, the divider, the limit, the change wait and the ending dmshow more

/perks role settings

how
one page: who can make a perk role (boosters after some months, a number of boosts, or only by hand), the divider every perk role goes under, the most roles, the wait between changes, the ending dm and staff approval. sharing opens the sharing page. sharing is off by default: staff who can change the server settings turn it on there, then pick who can share (boosters after some months, or with a number of boosts) and how many friends each booster can have (1 to 10, 2 by default). a booster gives their role to friends with share my role, and the friend accepts in a dm. a perk role has no permissions. when the perk ends, the role is deleted 3 days later.
example
/perks role settings
options

no options, just run it.

who
staff who can change the server settings
balqis needs
manage roles

perk roles for staff

give, take, link and check perk roles.

/perks role givelet one member make a perk role, whatever the rule isshow more

/perks role give <member>

how
lets one member make a perk role, whatever the rule is. they press make my role.
example
/perks role give member:@pyqa
options
  • member needed member the member
who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules
balqis needs
manage roles
/perks role takedelete a member's perk role nowshow more

/perks role take <member> [reason] [dm]

how
deletes a member's perk role now, and ends a role you gave by hand. dm yes or no.
example
/perks role take member:@pyqa reason:left the server
options
  • member needed member the member
  • reason optional text why (default: no reason given)
  • dm optional yes or no tell the member in a dm (empty: the ending dm setting)
who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules
balqis needs
manage roles
/perks role resetlet a member change their perk role again nowshow more

/perks role reset <member>

how
lets a member change their perk role again now, without the wait.
example
/perks role reset member:@pyqa
options
  • member needed member the member
who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules
/perks role listshow every perk role, who has it and which ones are endingshow more

/perks role list

how
every perk role, who has it, since when, and which ones are ending.
example
/perks role list
options

no options, just run it.

who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules

thank your boosters?

add balqis to your server, then run /perks role send to post the perk panel.

add to server