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
triggerneeded text what the member must do pick: server tag, boosting, status words, tag + boosting, tag + status wordsroleneeded role the vanity rolewordsoptional 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
ruleneeded 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
minutesneeded 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
memberneeded member the memberreasonoptional 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
memberneeded 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
channeloptional channel where the panel goeschannel-idoptional 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
memberneeded 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
memberneeded member the memberreasonoptional text why (default: no reason given)dmoptional 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 linkmake an old custom role a member's perk roleshow more
/perks role link <member> <role>
- how
- makes an old custom role a member's perk role. balqis asks first before it removes the role's permissions.
- example
/perks role link member:@pyqa role:@old role- options
memberneeded member the memberroleneeded role their old custom role
- 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
memberneeded 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.