Skip to main content
quickrank

Quickrank


Quickrank can be set up to allow admins to rank people quickly on a server.
After setup, you can react like this:
you
Give me a rank
:sub10:
1
:success:
1

Or send a message like this:
you
ip!rank @person sub-10

to give a user one or more roles
inter·punct BOT
@person, You were given the roles @🕐︎ SUB-10, @🕐︎ SUB-15, @🕐︎ SUB-20 by @admin


Setup


To set up a system like the example above, first each role must be given either a name, emoji, or both, and then a chain of provides must be set up.
Reactions:
you
ip!quickrank add reaction :sub10: @🕐︎ SUB-10

you
ip!quickrank add reaction :sub15: @🕐︎ SUB-15

you
ip!quickrank add reaction :sub20: @🕐︎ SUB-20

You might also want to make it so these emojis are given to people as rewards for getting these roles, for more about that see
Emoji. Make sure you give your admin roles access to the emoji too though!

Names:
you
ip!quickrank add named sub-10 @🕐︎ SUB-10

you
ip!quickrank add named sub-15 @🕐︎ SUB-15

you
ip!quickrank add named sub-20 @🕐︎ SUB-20

Note that the name must be surrounded in `backticks` if there are multiple words.

Provides:
If you give someone one role, provides will automatically add any other roles they need too. For example, if I rank someone sub-10 I also want to give them sub-15 and sub-20. Also, if I rank someone sub-15, I also want to give them sub-20. To do this, I can set up a provides chain so sub-10 provides sub-15 and sub-15 provides sub-20.
you
ip!quickrank add provides @🕐︎ SUB-10 -> @🕐︎ SUB-15

you
ip!quickrank add provides @🕐︎ SUB-20 -> @🕐︎ SUB-20

Now you can use the
ip!rank command to give people the roles sub-10, 15, or 20, and you can also react to messages and click check mark to give people these roles quickly.

If you make any mistakes, remove a role with
ip!quickrank remove role @roleRemove a role from quickrank entirely (reaction, named, time, provides)
To view the entire quickrank configuration, use
ip!quickrank listlist all quickrank configuration.

Relevant Commands


rank


Usage:
ip!rank user comma, separated, list, of, role, names
rank someone with a given list of roles. role names must be configured with quickrank.

quickrank list


Usage:
ip!quickrank list
list all quickrank configuration.

quickrank add named


Usage:
ip!quickrank add named backtick surrounded name @role
Permissions:
runner needs manage_bot.
add a rank name to be used in the
ip!rank command

quickrank add reaction


Usage:
ip!quickrank add reaction :emoji: @role
Permissions:
runner needs manage_bot.
add a reaction to react to messages and click check with to rank people

quickrank add provides


Usage:
ip!quickrank add provides @role 1 -> @role 2
Permissions:
runner needs manage_bot.
when ranking users with role 1, also give them role 2.

quickrank remove role


Usage:
ip!quickrank remove role @role
Permissions:
runner needs manage_bot.
Remove a role from quickrank entirely (reaction, named, time, provides)

quickrank set role


Usage:
ip!quickrank set role role
Permissions:
runner needs manage_bot.
set a role that allows members to quickrank even if they do not have permissions to manage roles. Keep in mind that this will allow people with this role to give people any of the roles configured in quickrank. If you don't want them giving away admin roles, make sure not to put those in quickrank.

Errors


Errors


invalid-roleI could not find that role. Make sure you spelled it right, and that it is configured with Quickrank .
More info:
Quickrankallow moderators to rank people quickly