Loading blood.best

DOCS / AUTOMATION & ROLES

Roles commands

37 public roles command entries, with syntax, aliases, permissions, and examples.

Commands in this category

boosterrole, role, roles. Open a command below for its syntax and requirements.

Before running a command

Replace placeholder arguments with the intended server, member, role, channel, or value. Check caller permissions and Blood’s role hierarchy before performing administrative actions. Examples are syntax references, not instructions to change your server. The command reference guide explains argument notation.

Command quick reference

This list is generated from Blood’s public command registry. It contains the same syntax, aliases, permissions, and descriptions used by the bot.

,boosterroleView command

Manages your personal role while boosting the server

Aliases: br
Parameters: n/a
Requires: Server Booster

Discord command

,boosterrole create

,boosterrole createView command

Creates a plain booster role using your username

Aliases: new
Parameters: n/a
Requires: Server Booster

Discord command

,boosterrole create

,boosterrole filter (term|on|off)View command

Configures filtered terms for personal booster-role names

Aliases: None
Parameters: term, state
Requires: Manage Roles

Discord command

,boosterrole filter add forbidden

,boosterrole base (role)View command

Sets the role above all personal booster roles

Aliases: None
Parameters: role
Requires: Manage Roles

Discord command

,boosterrole base @Booster Roles

,boosterrole rename (new name)View command

Renames your personal booster role

Aliases: None
Parameters: new name
Requires: Server Booster

Discord command

,boosterrole rename alex's color

,boosterrole color (color)View command

Changes your personal booster role color

Aliases: colour
Parameters: color
Requires: Server Booster

Discord command

,boosterrole color purple

,boosterrole icon (emoji|url|remove)View command

Changes or removes your personal booster role icon

Aliases: None
Parameters: emoji, url, attachment
Requires: Server Booster

Discord command

,boosterrole icon 💗

,boosterrole removeView command

Deletes your personal booster role

Aliases: delete
Parameters: n/a
Requires: Server Booster

,boosterrole award (role)View command

Sets the role automatically awarded to new boosters

Aliases: None
Parameters: role
Requires: Manage Roles

Discord command

,boosterrole award @Server Booster

,boosterrole award viewView command

Shows the role awarded to server boosters

Aliases: None
Parameters: n/a
Requires: Manage Roles

,boosterrole award removeView command

Stops automatically awarding a booster role

Aliases: None
Parameters: n/a
Requires: Manage Roles

,boosterrole listView command

Lists all personal booster roles

Aliases: None
Parameters: n/a
Requires: Manage Roles

,boosterrole cleanupView command

Removes stale or invalid personal booster roles

Aliases: None
Parameters: n/a
Requires: Manage Roles

,boosterrole eligibility (role)View command

Allows additional reward roles to use personal-role commands

Aliases: eligible, access
Parameters: role
Requires: Manage Roles

Discord command

,boosterrole eligibility @Subscriber

,boosterrole eligibility listView command

Lists roles allowed to create personal roles

Aliases: None
Parameters: n/a
Requires: Manage Roles

,role (member) (role[, role...])View command

toggles one or more roles on a member

Aliases: None
Parameters: member, roles
Requires: Manage Roles Manage Server

Discord command

,role @alex Member, Events, Giveaways

,role filter (term|on|off)View command

Configures filtered terms for created role names

Aliases: None
Parameters: term, state
Requires: Manage Roles Manage Server

Discord command

,role filter add forbidden

,role icon (url/emoji/remove) (role)View command

sets or removes a role icon

Aliases: None
Parameters: icon, role, attachment
Requires: Manage Roles Manage Server

Discord command

,role icon 🔥 admin

,role add (member) (role[, role...])View command

adds one or more roles to a member

Aliases: None
Parameters: member, roles
Requires: Manage Roles Manage Server

Discord command

,role add @alex Member, Events, Giveaways

,role create (name) <color>View command

creates a new role

Aliases: None
Parameters: name, color
Requires: Manage Roles Manage Server

Discord command

,role create admin #ff0000

,role delete (role)View command

deletes a role

Aliases: None
Parameters: role
Requires: Manage Roles Manage Server

Discord command

,role delete admin

,role humans (role)View command

adds a role to all human members

Aliases: None
Parameters: role
Requires: Manage Roles Manage Server

Discord command

,role humans member

,role bots (role)View command

adds a role to all bots

Aliases: None
Parameters: role
Requires: Manage Roles Manage Server

Discord command

,role bots bot

,role humans remove (role)View command

removes a role from all human members

Aliases: None
Parameters: role
Requires: Manage Roles Manage Server

Discord command

,role humans remove member

,role bots remove (role)View command

removes a role from all bots

Aliases: None
Parameters: role
Requires: Manage Roles Manage Server

Discord command

,role bots remove bot

,role edit (role) <new name>View command

changes a role's name

Aliases: None
Parameters: role, new name
Requires: Manage Roles Manage Server

Discord command

,role edit admin administrator

,role mentionable (role)View command

toggles whether a role can be mentioned

Aliases: None
Parameters: role
Requires: Manage Roles

Discord command

,role mentionable Events

,role remove (member) (role[, role...])View command

removes one or more roles from a member

Aliases: None
Parameters: member, roles
Requires: Manage Roles Manage Server

Discord command

,role remove @alex Member, Events, Giveaways

,role color (color) (role)View command

changes a role's color

Aliases: None
Parameters: color, role
Requires: Manage Roles Manage Server

Discord command

,role color #ff0000 admin

,role hoist (role)View command

toggles whether a role is shown separately

Aliases: None
Parameters: role
Requires: Manage Roles

Discord command

,role hoist Staff

,role color gradient (color) (second color) (role)View command

sets a role's gradient colors

Aliases: None
Parameters: color, second color, role
Requires: Manage Roles Manage Server

Discord command

,role color gradient #ff0000 #eb4034 admin

,role topcolor (color) <member>View command

changes a member's highest manageable role color

Aliases: None
Parameters: color, member
Requires: Manage Roles

Discord command

,role topcolor #ff0000 alex

,role cancelView command

cancels the active mass-role operation

Aliases: None
Parameters: n/a
Requires: Manage Roles Manage Server

Discord command

,role cancel

,role has (role) (assign role)View command

adds a role to members with another role

Aliases: None
Parameters: role, assign role
Requires: Manage Roles Manage Server

Discord command

,role has mod admin

,role has remove (role) (remove role)View command

removes a role from members with another role

Aliases: None
Parameters: role, remove role
Requires: Manage Roles Manage Server

Discord command

,role has remove mod admin

,role restore (member)View command

restores a member's recent roles

Aliases: None
Parameters: member
Requires: Manage Roles Manage Server

Discord command

,role restore @blood

,rolesView command

shows all server roles

Aliases: None
Parameters: n/a
Requires: n/a