Loading blood.best

DOCS / AUTOMATION & ROLES

Levels commands

43 public levels command entries, with syntax, aliases, permissions, and examples.

Commands in this category

levels, removexp, setlevel, setxp, leaderboard, live. 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.

,levels <member>View command

Tracks activity XP, levels, leaderboards, and role rewards

Aliases: leveling, level, rank
Parameters: member
Requires: None

,removexp (member) (amount)View command

Removes activity XP from a member

Aliases: None
Parameters: member, amount
Requires: Manage Server

Discord command

,removexp @alex 500

,setlevel (member) (level)View command

Sets a member's exact activity level

Aliases: None
Parameters: member, level
Requires: Manage Server

Discord command

,setlevel @alex 10

,setxp (member) (xp)View command

Sets a member's exact activity XP

Aliases: None
Parameters: member, xp
Requires: Manage Server

Discord command

,setxp @alex 2500

,levels configView command

Views the server leveling configuration

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

,levels enableView command

Enables XP tracking

Aliases: unlock
Parameters: n/a
Requires: Manage Server

,levels lockView command

Pauses XP tracking without deleting progress

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

,levels messagexp (on|off)View command

Turns message XP earning on or off

Aliases: messagelevel
Parameters: state
Requires: Manage Server

Discord command

,levels messagexp off

,levels voice (on|off)View command

Turns voice XP earning on or off

Aliases: voicexp, voicelevel
Parameters: state
Requires: Manage Server

Discord command

,levels voice on

,levels cleanupView command

Removes XP records for members no longer in the server

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

,levels ignore (channel|thread|role)View command

Toggles a channel, thread, or role excluded from XP

Aliases: None
Parameters: channel, thread, role
Requires: Manage Server

Discord command

,levels ignore #spam

,levels ignore listView command

Lists channels and roles excluded from XP

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

,levels resetView command

Resets every member's XP and level without changing settings

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

,levels add (role) (level)View command

Awards a role at a level

Aliases: None
Parameters: role, level
Requires: Manage Server

Discord command

,levels add @Active 10

,levels remove (level)View command

Removes the reward configured at a level

Aliases: None
Parameters: level
Requires: Manage Server

Discord command

,levels remove 10

,levels update (role) (level)View command

Moves an existing level reward role to a new level

Aliases: None
Parameters: role, level
Requires: Manage Server

Discord command

,levels update @Active 20

,levels roles (subcommand) (args)View command

Configures roles awarded when members reach a level

Aliases: role
Parameters: subcommand, args
Requires: Manage Server

Discord command

,levels roles add @Active 10

,levels syncView command

Synchronizes all saved level reward roles with current XP

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

,levels listView command

Lists every configured level reward

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

Discord command

,levels list

,levels stackroles (on|off)View command

Controls whether members keep earlier level rewards

Aliases: None
Parameters: state
Requires: Manage Server

Discord command

,levels stackroles on

,levels setrate (0.1-5)View command

Changes the XP earning multiplier

Aliases: multiplier
Parameters: multiplier
Requires: Manage Server

Discord command

,levels setrate 1.5

,levels message (createembed code)View command

Sets the level-up message using createembed code

Aliases: None
Parameters: createembed code
Requires: Manage Server

Discord command

,levels message {message: {user.mention} has reached level {level}!}

,levels channel (channel)View command

Sets the channel for level-up messages

Aliases: None
Parameters: channel
Requires: Manage Server

Discord command

,levels channel #levels

,levels message viewView command

Previews the current level-up message

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

,levels messagemode (context|pm|none|channel)View command

Sets where level-up messages are delivered

Aliases: None
Parameters: mode
Requires: Manage Server

Discord command

,levels messagemode #levels

,leaderboardView command

Shows the server's level leaderboard

Aliases: None
Parameters: n/a
Requires: None

,levels leaderboard [all|1d|7d|30d|90d]View command

Shows an image leaderboard with server XP, levels, progress, and time ranges

Aliases: lb
Parameters: range
Requires: None

Discord command

,levels leaderboard 7d

,levels message resetView command

Restores the default plain level-up message

Aliases: default
Parameters: n/a
Requires: Manage Server

Discord command

,levels message reset

,levels message placeholdersView command

Lists placeholders available to level-up messages

Aliases: variables
Parameters: n/a
Requires: Manage Server

Discord command

,levels message placeholders

,levels messages (on|off)View command

Toggles your own level-up messages

Aliases: None
Parameters: setting
Requires: None

Discord command

,levels messages off

,levels leaderboard rename (title)View command

Changes the title of leaderboard images

Aliases: None
Parameters: title
Requires: Manage Server

Discord command

,levels leaderboard rename Most Active

,levels roles add (role) (level)View command

Awards a role when members reach a level

Aliases: None
Parameters: role, level
Requires: Manage Server

Discord command

,levels roles add @Active 10

,levels roles update (role) (level)View command

Moves an existing reward role to a new level

Aliases: None
Parameters: role, level
Requires: Manage Server

Discord command

,levels roles update @Active 20

,levels roles remove (level)View command

Removes the role reward configured at a level

Aliases: None
Parameters: level
Requires: Manage Server

Discord command

,levels roles remove 10

,levels roles listView command

Lists configured level reward roles

Aliases: None
Parameters: n/a
Requires: None

Discord command

,levels roles list

,levels voice channel (channel)View command

Sets where voice level-up messages are sent

Aliases: None
Parameters: channel
Requires: Manage Server

Discord command

,levels voice channel #levels

,levels voice message (createembed code)View command

Sets the voice level-up message using createembed code

Aliases: None
Parameters: createembed code
Requires: Manage Server

Discord command

,levels voice message {message: {user.mention} reached voice level {level}!}

,levels voice messageviewView command

Previews the current voice level-up message

Aliases: view
Parameters: n/a
Requires: Manage Server

,liveView command

Manages self-refreshing activity leaderboards

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

Discord command

,live text #leaderboards
live voice #leaderboards

,live text <channel>View command

Posts a live 30-day message leaderboard that refreshes every five minutes

Aliases: None
Parameters: channel
Requires: Manage Server; analytics must be enabled

Discord command

,live text #leaderboards

,live voice <channel>View command

Posts a live 30-day voice-time leaderboard that refreshes every five minutes

Aliases: None
Parameters: channel
Requires: Manage Server; analytics must be enabled

Discord command

,live voice #leaderboards

,live statusView command

Shows this server's persistent live leaderboards

Aliases: list
Parameters: n/a
Requires: Manage Server

,live remove (text|voice)View command

Stops and removes a live activity leaderboard

Aliases: delete, disable
Parameters: board type
Requires: Manage Server

Discord command

,live remove voice