Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Apeuriox/lazybot-renewal/llms.txt

Use this file to discover all available pages before exploring further.

Lazybot’s comparison commands let you measure yourself against others — whether that’s a full side-by-side analysis of two players’ best performance lists, a quick peek at your own score on a map your groupmate just posted, a leaderboard of every linked member in your chat group, or a hypothetical projection of what your total PP would look like if you farmed a few extra plays.

​
/bpvs — Side-by-Side BP Comparison

Alias: bpvs Compares the best performance lists of two players head-to-head across BP slots 1–100. The output panel highlights which BP slots each player holds that the other does not, making it easy to see where one player has an advantage. You can specify the two players either by passing a target name separately or by combining both names with # as a separator (e.g. Aloic#Apeuriox).
​
target
string
The player to compare against. Can also combine both players as PlayerA#PlayerB in a single argument.
​
mode
string
Game mode for both players. Accepted values: osu, taiko, catch / fruits, mania. Defaults to the caller’s saved default mode.

​
Examples

/bpvs target:Aloic
/bpvs target:Aloic mode:taiko

​
/compare — Quick Score Comparison on Active Map

Aliases: c, compare Automatically detects the most recently posted score in the current QQ group chat and shows your own score on that same beatmap. You don’t need to type a beatmap ID — Lazybot reads it from the chat context. Optionally pass a numeric index (1–5) to look back up to five recently posted scores.
​
index
integer
How far back in the recent posted scores to look. Range: 1–5. Defaults to 1 (the most recent score posted by anyone in the group).

​
Examples

/compare
/c
/compare 2
/c 3
/compare is most useful immediately after a groupmate posts their score card. Send /c right after and Lazybot will instantly show how your best play on that map stacks up against theirs — no copy-pasting beatmap IDs required.
/compare is currently a QQ/OneBot-only command. The Discord slash command implementation is pending.

​
/scorerank — Group Leaderboard for a Beatmap

Aliases: rank, sr, scorerank Queries every player linked to the current QQ group and displays a leaderboard of their scores on the specified beatmap. Shows up to 30 results. A rate limit of 3 requests per 50 seconds per channel applies to prevent API overload.
​
bid
integer
required
Beatmap ID to rank scores on. Append +MOD for a mod-filtered leaderboard (e.g. 4889657+HDDT).
​
mod
string
Mod filter to apply. Can also be appended directly to the BID on QQ using + syntax.
​
mode
string
Game mode override. If your group plays multiple modes, specify this to avoid mode mismatches.

​
Examples

/sr 4889657
/rank 4889657+HDDT
/scorerank 4889657
/scorerank is QQ/OneBot-only and only functions inside group chats. It will not respond in private messages. Additionally, the group member list is fetched live, so members who have not linked their osu! account will be excluded from the leaderboard.

​
/whatif — PP Projection Simulation

Alias: whatif Simulates how your total PP would change if you added one or more hypothetical scores to your best performance list. Pass a series of PP*count expressions to model multiple plays at once.
​
PP Series
string
required
One or more value*count expressions. For example, 300*10 means ten scores worth 300 PP each. Multiple entries are separated by spaces.

​
Examples

/whatif 300*10 400*5
/whatif 500*1
Use /whatif to answer questions like “if I farm 10 maps worth ~350 PP, how much will my total increase?” The calculation accounts for the weighted BP decay, so the result is more accurate than a simple linear sum.

​
/nametoid — Player Name to osu! ID

Aliases: nametoid, n2d Converts a comma-separated list of osu! player names to their numeric user IDs. Useful when you need IDs for API queries, tournament sheets, or configuration files. Up to 10 names per request.
​
list
string
required
Comma-separated list of osu! player names. Maximum 10 names per call. Example: Aloic,Pager,Hidden is fun,Zh_jk.

​
Examples

/nametoid list:Aloic,Pager,Zh_jk

Build docs developers (and LLMs) love

Get started for freeTalk to us