balqis

role panels and tools

members pick roles; give, take and make roles

/roles panel create makes a panel where members pick their own roles (buttons or a menu); /roles panel send posts it.
/roles join gives roles to new members, /roles give and /roles take give or take one role (it can end by itself), /roles everyone gives one role to everyone.
/roles create and /roles edit make roles, /roles info shows everything about a role.
tip: balqis can only give roles that are below its own top role.

  • 22 commands
  • role panels: 5 free, 50 with premium
  • role views: 5 free, 10 with premium

playground

pick a color

a role panel in #roles. press a color and get the role, no staff needed.

# roles

balqisapptoday

pick your color

one color at a time. press it again to take it off.

balqisapptoday

only you can see this

your roles · colors

you got @strawberry

[undo] works for 60 seconds.

you are atid. press a color.

role panels

members pick their own roles.

/roles panel createmake a role panelshow more

/roles panel create <name> <kind> <mode>

how
make a panel: buttons or a menu, and a mode (toggle, only one, add only, remove only or pick once).
example
/roles panel create name:colors kind:buttons mode:only one
options
  • name needed text up to 32 letters
  • kind needed text buttons or one menu pick: buttons, menu
  • mode needed text what a press does pick: toggle, only one, add only, remove only, pick once
who
staff who can change the server settings
/roles panel addadd a role to a panel, or change its textsshow more

/roles panel add <panel> <role> [label] [emoji] [line]

how
put a role on a panel, with its label, emoji and a line about it. or change them.
example
/roles panel add panel:colors role:@strawberry label:strawberry
options
  • panel needed text the role panel
  • role needed role the role members can pick
  • label optional text name on it (empty: the role name)
  • emoji optional text :name: or an emoji
  • line optional text short line under it in a menu
who
staff who can change the server settings
/roles panel removetake a role off a panelshow more

/roles panel remove <panel> [role] [role-id]

how
take a role off a panel. members who have it keep it.
example
/roles panel remove panel:colors role:@strawberry
options
  • panel needed text the role panel
  • role optional role the role to take off
  • role-id optional text or the id of a deleted role
who
staff who can change the server settings
/roles panel sendsend a panel to a channel (empty: this channel)show more

/roles panel send <panel> [channel] [channel-id]

how
send a panel to a channel (this one when you leave it empty).
example
/roles panel send panel:colors channel:#roles
options
  • panel needed text the role panel
  • channel optional channel text, announcement or thread
  • 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
/roles panel settingschange a panel: kind, mode, who can use it, its roles, sendshow more

/roles panel settings <panel>

how
change a panel: its kind, mode, who can use it and its roles.
example
/roles panel settings panel:colors
options
  • panel needed text the role panel
who
staff who can change the server settings
/roles panel listshow the panels, where they were sent and their problemsshow more

/roles panel list

how
your panels, where they were sent and their problems.
example
/roles panel list
options

no options, just run it.

who
staff who can change the server settings
/roles panel deletedelete a panel (sent messages stay)show more

/roles panel delete <panel>

how
deletes a panel. messages already sent stay.
example
/roles panel delete panel:colors
options
  • panel needed text the role panel
who
staff who can change the server settings
/roles panel resetlet a member pick again on a pick once panelshow more

/roles panel reset <member> <panel>

how
let a member pick again on a pick once panel.
example
/roles panel reset member:@atid panel:team
options
  • member needed member the member
  • panel needed text the role panel
who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules

give and take

one member, everyone, or new members.

/roles givegive one role to one membershow more

/roles give <member> <role> [lasts] [reason] [dm]

how
give one role to one member. lasts makes it end by itself.
example
/roles give member:@atid role:@event lasts:7d
options
  • member needed member the member
  • role needed role the role
  • lasts optional text it ends by itself after this, like 7d (empty: never)
  • reason optional text why (default: no reason given)
  • dm optional yes or no send them a dm first (empty: server 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
/roles taketake one role off one membershow more

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

how
take one role off one member.
example
/roles take member:@atid role:@event
options
  • member needed member the member
  • role needed role the role
  • reason optional text why (default: no reason given)
  • dm optional yes or no send them a dm first (empty: server 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
/roles everyonegive or take one role for the members already in the server, in the backgroundshow more

/roles everyone <action> <role> [who] [with-role] [without-role]

how
give or take one role for everyone already in the server (or only people, or bots), in the background.
example
/roles everyone action:give role:@member who:people
options
  • action needed text give or take pick: give, take
  • role needed role the role
  • who optional text empty: everyone pick: everyone, people, bots
  • with-role optional role only members who have this role
  • without-role optional role only members who do not have this role
who
staff who can change the server settings
balqis needs
manage roles
/roles joinroles balqis gives when someone joins: one list for people, one for botsshow more

/roles join

how
the roles balqis gives when someone joins: one list for people, one for bots.
example
/roles join
options

no options, just run it.

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

make roles

color, style, icon and permissions on a page.

/roles createmake a new role on a page: color, style, icon, permissionsshow more

/roles create <name>

how
make a new role on one page: color, style, icon and permissions.
example
/roles create name:strawberry
options
  • name needed text the role name
who
staff who can change the server settings
balqis needs
manage roles
/roles editchange a role on a page: name, color, style, icon, permissionsshow more

/roles edit <role>

how
change a role on one page: name, color, style, icon and permissions.
example
/roles edit role:@strawberry
options
  • role needed role the role
who
staff who can change the server settings
balqis needs
manage roles
/roles infoshow everything about a role: look, members, permissions, its jobs in balqisshow more

/roles info <role>

how
everything about a role: its look, members, permissions and its jobs in balqis.
example
/roles info role:@strawberry
options
  • role needed role the role
who
anyone with the roles ability (the mod preset and up), or the manage roles permission when the server set no access rules
/roles preset addmake a permission preset for new roles (only permissions you have)show more

/roles preset add <name>

how
save a set of permissions to use for new roles (only permissions you have yourself).
example
/roles preset add name:helper
options
  • name needed text the preset name
who
staff who can change the server settings
/roles preset listshow the permission presets of this servershow more

/roles preset list

how
the permission presets of this server.
example
/roles preset list
options

no options, just run it.

who
staff who can change the server settings
/roles preset removeremove a permission preset (roles made with it do not change)show more

/roles preset remove <preset>

how
removes a permission preset. roles made with it do not change.
example
/roles preset remove preset:helper
options
  • preset needed text the preset
who
staff who can change the server settings

views

a role that sees only the channels you pick.

/roles view setmake or change a view: a role that sees only the channels you pickshow more

/roles view set [role]

how
make or change a view: a role that sees only the channels you pick.
example
/roles view set role:@event
options
  • role optional role the view role (empty: pick it, or let balqis make one)
who
staff who can change the server settings
balqis needs
manage roles, manage channels
/roles view listthe views of this server, their numbers and their problemsshow more

/roles view list

how
the views of this server, their numbers and their problems.
example
/roles view list
options

no options, just run it.

who
staff who can change the server settings
/roles view removeremove a view: balqis takes off its own rules and gives paused roles backshow more

/roles view remove <view>

how
removes a view: balqis takes off its own channel rules and gives paused roles back.
example
/roles view remove view:event
options
  • view needed text the view
who
staff who can change the server settings
balqis needs
manage roles, manage channels
/roles view syncput every rule of a view back on the channels (empty: every view)show more

/roles view sync [view]

how
puts every rule of a view back on the channels (every view when you leave it empty).
example
/roles view sync
options
  • view optional text the view (empty: every view)
who
staff who can change the server settings
balqis needs
manage roles, manage channels

want members to pick their own roles?

add balqis to your server, then make a panel with /roles panel create.

add to server