Best Performance Commands — /bp, /bplist, /nochoke, and More

Best Performance commands are the analytical core of Lazybot. From fetching a single BP entry with PP breakdown, to simulating full-combo rewrites of all 200 BPs, to filtering your top plays by star rating, title, or mod combination — these commands turn raw leaderboard data into actionable insight.

`/bp` — Single Best Performance Entry

Aliases: best, pbp, b, bsm Fetches a single entry from a player’s best performance list. Defaults to BP #1 if no index is specified. The alias pbp (or pb) switches the panel to a PP+ quadrant grid. The alias bsm queries the Star Moon private server instead of the official osu! API.

user

string

Player name to query. Defaults to the caller’s linked account.

index

integer

Which BP slot to retrieve. Range: 1–200. Defaults to 1.

mode

string

Game mode. Accepted values: osu, taiko, catch / fruits, mania. Defaults to the user’s saved default mode.

algorithm

string

PP algorithm version: 202210, 202411, 202502, 202510, 20260706. Omit to use the server-configured default.

version

integer

Panel style. On QQ controlled by the count of & appended to the command.

Examples

Discord
QQ / OneBot

/bp
/bp index:10 user:Aloic
/bp index:10 user:Aloic algorithm:202502

/bp #1
/bp Aloic #10
/bp Aloic #10 @202502
/bp Aloic #10 &
/pbp Aloic #5
/bsm #1

Star Moon (bsm) is a separate private osu! server. To use /bsm you must have a Star Moon account linked to your QQ via /linkstarmoon. This command is QQ-only.

Use different algorithm values to compare how a score would rank under different PP reworks. For example, passing @202210 shows what your BP would look like under the October 2022 system.

`/bplist` — BP List View

Alias: bplist Fetches a range of BP entries and renders them as a compact list panel. Maximum range is 1–200.

from

integer

required

Starting index of the range (inclusive).

integer

required

Ending index of the range (inclusive). Maximum 200.

user

string

Player name. Defaults to the caller’s linked account.

mode

string

Game mode override.

algorithm

string

PP algorithm version string.

Examples

/bplist 1-21
/bplist Aloic 1-21
/bplist Aloic 1-21 @202502

`/bpcard` — BP Card View

Alias: bpcard Same range query as /bplist but renders each entry as a card thumbnail instead of a list row. Render limit is 100 entries per call (the fetch limit remains 200).

from

integer

required

Starting index of the range.

integer

required

Ending index (max 200; render cap 100).

user

string

Player name.

mode

string

Game mode override.

algorithm

string

PP algorithm version string.

Examples

/bpcard 1-21
/bpcard Aloic 1-21
/bpcard Aloic 1-21 @202502

`/bps` — BP Series Quick-Access

Aliases: bs, bssm A shortcut equivalent to /bpcard 1-[index]. Defaults to showing BP 1–21. Appending & switches the output to list style instead of card style.

user

string

Player name.

index

integer

Upper bound of the range. Defaults to 21.

version

string

Pass & to render as a list instead of cards.

Examples

/bs
/bs Aloic
/bs Aloic 31 &

`/bpif` — BP Simulation with Mod Changes

Alias: bpif Recalculates and re-ranks all 200 BPs after applying a mod rule, then shows the projected total PP change. Three operators are supported:

Operator	Effect
`+`	Insert the specified mods (conflicting or duplicate mods are silently ignored)
`-`	Remove the specified mods
`!`	Replace all existing mods with the specified mods

operator

string

One of +, -, or !. Can be omitted when only specifying an algorithm version.

mods

string

Mod abbreviation string without spaces, e.g. HDHR, DT, HDDT. Can be omitted when only changing the algorithm.

user

string

Player name.

mode

string

Game mode override.

algorithm

string

PP algorithm version string.

rendersize

string

Maximum number of entries to render in the output image. Defaults to 30.

Examples

/bpif +HD
/bpif Aloic -HDHR
/bpif !HDDT
/bpif @202502
/bpif +HD @202411

`/nochoke` — Full-Combo Simulation

Aliases: nc, nochoke Simulates a full combo (FC) on every BP in the user’s top 200 and re-ranks them, showing the theoretical maximum total PP. A disclaimer is included in the output reminding users that FC simulation does not perfectly represent skill.

user

string

Player name.

mode

string

Game mode override.

algorithm

string

PP algorithm version string.

Examples

/nochoke
/nochoke Aloic
/nc Aloic
/nochoke Aloic @202411

`/no1miss` — FC Simulation for Near-FC Plays

Alias: no1miss (shares implementation with /nochoke) Like /nochoke, but only recalculates BPs that have ≤ 1 miss. This is a more realistic simulation for players who regularly get single-miss scores on hard maps.

user

string

Player name.

mode

string

Game mode override.

algorithm

string

PP algorithm version string.

Examples

/no1miss
/no1miss Aloic

`/todaybp` — New BPs Within a Time Range

Alias: tbp Shows BP entries that were set within a specified number of days. Useful for tracking recent grinding sessions or checking what a player has improved on lately.

user

string

Player name.

mode

string

Game mode override.

days

string

Number of days to look back. Defaults to 1 (today only).

Examples

/tbp
/tbp Aloic
/todaybp Aloic #10

`/topscores` — Highest PP Scores on the Instance

Alias: ts Lists the highest-PP scores across all linked players on this Lazybot instance for a given mode. Data is sourced from osu!Track and may not always be perfectly up to date.

mode

string

Game mode to query. Defaults to osu.

limit

string

Maximum number of results to display. Defaults to 10. An internal filter is applied, so the actual count shown may be lower.

Examples

/topscores
/topscores mode:taiko
/ts 20

`/filter` — Filter BP200 by Conditions

Alias: f

This command is currently in a testing phase. Behaviour may change.

Filters a player’s top 200 BPs by one or more conditional expressions. Conditions are separated by commas (,). Field names and operators are case-insensitive. Maximum render output is 51 entries. Condition syntax: [Field][Operator][Value]

Supported Fields

Field	Description
`Accuracy` / `acc`	Score accuracy (%)
`Artist`	Song artist
`AR`	Approach rate
`BPM`	Beats per minute
`Combo`	Maximum combo achieved
`Circle`	Hit circle count
`Creator` / `Mapper`	Beatmap creator
`Difficulty` / `Diff` / `Version`	Difficulty name
`Great` / `300`	300-count
`HP`	HP drain rate
`Length`	Map length in seconds
`Meh` / `50`	50-count
`MaxCombo`	Maximum possible combo
`Mod` / `Mods`	Active mods
`Miss` / `0`	Miss count
`OK` / `100`	100-count
`OD`	Overall difficulty
`PP` / `Performance`	Performance points
`Rank`	Score rank (Lazer algorithm)
`Slider`	Slider count
`Spinner`	Spinner count
`Star`	Star rating
`Title` / `Name`	Beatmap title

Supported Operators

Numeric fields:

Operator	Meaning
`>`	Greater than
`>=`	Greater than or equal
`<`	Less than
`<=`	Less than or equal
`==` or `=`	Equal
`!=`	Not equal

Text fields:

Operator	Meaning
`==`	Exact match
`^=`	Starts with
`$=`	Ends with
`~`	Similar (fuzzy)
`=`	Contains
`!=`	Not equal

Mod fields:

Operator	Meaning
`=`	Contains mod(s)
`==`	Exact mod set

Examples

/filter Star>7
/f Star>7, Bpm<230, Title^=I
/f Mod=HD, PP>=400
/filter Rank=S, Miss=0

osu! Commands

Badge & Card System

Fun & Utilities

Best Performance Commands — /bp, /bplist, /nochoke, and More

`/bp` — Single Best Performance Entry

Examples

`/bplist` — BP List View

Examples

`/bpcard` — BP Card View

Examples

`/bps` — BP Series Quick-Access

Examples

`/bpif` — BP Simulation with Mod Changes

Examples

`/nochoke` — Full-Combo Simulation

Examples

`/no1miss` — FC Simulation for Near-FC Plays

Examples

`/todaybp` — New BPs Within a Time Range

Examples

`/topscores` — Highest PP Scores on the Instance

Examples

`/filter` — Filter BP200 by Conditions

Examples

Build docs developers (and LLMs) love

osu! Commands

Badge & Card System

Fun & Utilities

Documentation Index

​/bp — Single Best Performance Entry

​Examples

​/bplist — BP List View

​Examples

​/bpcard — BP Card View

​Examples

​/bps — BP Series Quick-Access

​Examples

​/bpif — BP Simulation with Mod Changes

​Examples

​/nochoke — Full-Combo Simulation

​Examples

​/no1miss — FC Simulation for Near-FC Plays

​Examples

​/todaybp — New BPs Within a Time Range

​Examples

​/topscores — Highest PP Scores on the Instance

​Examples

​/filter — Filter BP200 by Conditions

​Examples

Build docs developers (and LLMs) love

`/bp` — Single Best Performance Entry

Examples

`/bplist` — BP List View

Examples

`/bpcard` — BP Card View

Examples

`/bps` — BP Series Quick-Access

Examples

`/bpif` — BP Simulation with Mod Changes

Examples

`/nochoke` — Full-Combo Simulation

Examples

`/no1miss` — FC Simulation for Near-FC Plays

Examples

`/todaybp` — New BPs Within a Time Range

Examples

`/topscores` — Highest PP Scores on the Instance

Examples

`/filter` — Filter BP200 by Conditions

Examples