Records

best50¶

(aliases: b50, best30, b30)

View the rating breakdown of a player.

Text commandSlash command

c>best50 [-c] [-k] [-n] [user]

Options

user: (default: you) The user to get the rating breakdown for.
-c, --classic: View the breakdown using Discord embeds instead of generating an image.
-k, --kamaitachi: View the user's breakdown on Kamaitachi, if available.
-n, --new-rating: When viewing on Kamaitachi, calculate a best30+new20 split instead of best50.

/best50 [user:<user>] [classic:<True|False>] [kamaitachi:<True|False>] [new-rating:<True|False>]

Options

user: (default: you) The user to get the rating breakdown for.
classic: (default: False) View the breakdown using Discord embeds instead of generating an image.
kamaitachi: (default: False) View the user's breakdown on Kamaitachi, if available.
new-rating: (default: False) When viewing on Kamaitachi, calculate a best30+new20 split instead of best50.

compare¶

(aliases: c, mog, gap)

Compare a user's score to a recent chart or score card.

By default, the most recent message containing a chart or score card is chosen. If the message contains multiple cards, you will be prompted to select one.

Text command only: You can choose another message by replying to the message when invoking the command.

Text commandSlash command

c>compare [-k] [user]

Options

user: (default: you) The user to get the score of.
-k, --kamaitachi: View the user's score on Kamaitachi, if available.

/compare [user:<user>] [kamaitachi:<True|False>]

Options

user: (default: you) The user to get the score of.
kamaitachi: (default: False) View the user's score on Kamaitachi, if available.

leaderboard¶

(aliases: lb)

View the leaderboard for a chart. The default network is Kamaitachi if you only have a Kamaitachi account linked, else it is CHUNITHM-NET International.

Text commandSlash command

c>leaderboard [-k] <difficulty> <query...>

Options

difficulty: The difficulty of the chart.
query: The title of the song. You don't have to be exact; try things out!
-c, --chunithm-net: View the CHUNITHM-NET International leaderboard for the song.
-k, --kamaitachi: View the Kamaitachi leaderboard for the song.

/leaderboard difficulty:<difficulty> query:<query> [kamaitachi:<True|False>]

Options

difficulty: The difficulty of the chart.
query: The title of the song. You don't have to be exact; try things out!
chunithm-net: (default: False) View the CHUNITHM-NET International leaderboard for the song.
kamaitachi: (default: False) View the Kamaitachi leaderboard for the song.

recent¶

(aliases: rs)

View a user's most recent scores.

Text commandSlash command

c>recent [-k] [user]

Options

user: (default: you) The user to get recent scores of.
-k, --kamaitachi: View the user's recent scores on Kamaitachi, if available.

/recent [user:<user>] [kamaitachi:<True|False>]

Options

user: (default: you) The user to get recent scores of.
kamaitachi: (default: False) View the user's recent scores on Kamaitachi, if available.

scores¶

(aliases: score)

Get a user's scores for a specific song, or compare the user's scores with another score.

Text commandSlash command

c>scores [-k] [user] [query...]

Options

query: The title of the song. You don't have to be exact; try things out! If a query was not specified, the command works the same as compare.
user: (default: you) The user to get the score of.
-k, --kamaitachi: View the user's score on Kamaitachi, if available.

/scores query:<query> [user:<user>] [kamaitachi:<True|False>]

Options

query: The title of the song. You don't have to be exact; try things out!
user: (default: you) The user to get the score of.
kamaitachi: (default: False) View the user's score on Kamaitachi, if available.

top¶

Get a user's best scores for a specified set of charts.

Text commandSlash command

c>top [-k] [-d <difficuly>] [-g <genre>] [-r <rank>] [-s <sort...>] [user] [level]

Options

user: (default: you) The user to get the score of.
level: (default: None) Get scores from the specified level, from 1 to 15+. Chart constants are also supported.
-d, --difficulty: Get scores from the specified difficulty. Must be one of BASIC, ADVANCED, EXPERT, MASTER, ULTIMA or WE, or any common abbreviations such as MAS.
-g, --genre: Get scores for songs in the specified genre.
-r, --rank: Get scores from the specified rank.
-s, --sort: Sort scores by the specified metric. You can specify multiple metrics, e.g. -s score clear_lamp. You can optionally add + or - after a metric to sort in ascending or descending order, e.g. score+. The default is to sort by rating, then score, then overpower, then note lamp, then clear lamp, all in descending order. Supported options are:
- score: Sort by score.
- rating: Sort by calculated play rating. Might not work if there are unknown songs.
- overpower: Sort by calculated raw overpower value.
- overpower_percent: Sort by calculated overpower percentage.
- note_lamp: Sort by note lamp (also known as combo lamp, e.g. FULL COMBO/ALL JUSTICE).
- clear_lamp: Sort by clear lamp (FAILED, CLEAR, HARD, BRAVE, ABSOLUTE, CATASTROPHY).
- life: Sort by total number of JUSTICE/ATTACK/MISS, if data is available.
-v, --version: Version to search for.
-k, --kamaitachi: View the user's scores on Kamaitachi, if available.

/top [user:<user>] [level:<level>] [difficulty:<difficulty>] [genre:<genre>] [rank:<rank>] [sort:<sort>] [sort_order:<ascending|descending>] [version:<version>] [kamaitachi:<True|False>]

Options

user: (default: you) The user to get the score of.
level: (default: None) Get scores from the specified level, from 1 to 15+.
difficulty: (default: None) Get scores from the specified difficulty.
genre: (default: None) Get scores for songs in the specified genre.
rank: (default: None) Get scores from the specified rank.
sort: (default: rating) Sort scores by the specified metric.
sort_order: (default: descending) Sort scores in ascending or descending order.
version: (default: None) Version to search for.
kamaitachi: (default: False) View the user's scores on Kamaitachi, if available.

statistics¶

(aliases: stats, folder, progress)

View statistics about a folder.

Text commandSlash command

c>statistics [-d DIFFICULTY] [-g GENRE] [-v VERSION] [-k] [-o] [--refresh] [user] [level]

Options

user: Discord username of the player. Yourself, if not provided.
level: Level (from 1 to 15+) to search for. Can also be a level range (e.g. 14.3-14.5).
-d, --difficulty: Difficulty to search for. Must be one of BASIC, ADVANCED, EXPERT, MASTER, ULTIMA, or WE if specified.
-g, --genre: Genre to search for.
-v, --version: Version to search for.
-k, --kamaitachi: Get scores from Kamaitachi, if the target user has a linked account.
-o, --omnimix: Count removed songs towards statistics and the final count.

/statistics [user:<user>] [level:<level>] [difficulty:<difficulty>] [genre:<genre>] [version:<version>] [kamaitachi:<True|False>] [omnimix:<True|False>] [refresh:<True|False>]

Options

user: (default: you) The user to get the score of.
level: (default: None) Level (from 1 to 15+) to search for. Can also be a level range (e.g. 14.3-14.5).
difficulty: (default: None) Difficulty to search for.
genre: (default: None) Genre to search for.
version: (default: None) Version to search for.
kamaitachi: (default: False) Get scores from Kamaitachi, if the target user has a linked account.
omnimix: (default: False) Count removed songs towards statistics and the final count.

sync¶

(aliases: refresh, update)

Sync scores with the bot.

It is usually not necessary to use this command, since the bot will automatically track scores as they are fetched from other commands like best50 or recent.

Currently scores stored in the bot are only used for statistics. This may change in the future.

Text commandSlash command

c>sync [-k] [user]

Options

user: The user to sync scores for. Yourself, if not specified.
-k, --kamaitachi: Sync the user's Kamaitachi scores.

/sync [user:<user>] [kamaitachi:<True|False>]

user: (default: you) The user to sync scores for.
-k, --kamaitachi: (default: False) Sync the user's Kamaitachi scores.