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 PP analysis tools go beyond the raw performance point number to reveal the underlying skill dimensions behind every score. Whether you want a multi-axis PP+ breakdown, a time-series scatter plot of your historical BP, a recommended star rating for your next farm session, or a simulation of how reading ability affects your PP — these commands surface insight that the osu! website alone cannot provide.
PP+ is an external, community-built metric and is not part of the official osu! PP system. PP+ scores are calculated by Lazybot’s integrated PP+ service and may differ from any third-party site. Use /update plus to refresh your PP+ data before querying.

/ppp — PP+ Performance Breakdown

Alias: plus Displays a player’s PP+ profile card showing their skill breakdown across multiple performance dimensions: Aim, Speed, Accuracy, Stamina, and Precision. Appending & switches to the Corsace Open 2024 legacy panel variant instead of the default modern card style.
user
string
Player name. Defaults to the caller’s linked account.
mode
string
Game mode. Currently PP+ data is primarily available for osu (standard) mode.
version
string
Pass & to render the Corsace Open 2024 legacy panel style. Default renders the modern coloured card; the main colour follows the player’s profile page accent.

Examples

/ppp
/ppp Aloic &
/plus &

/pstats — PP+ Service Statistics

Alias: pstats Returns server-side statistics about the PP+ calculation service. Useful for administrators monitoring data coverage.
type
string
required
Statistic to retrieve. Accepted values:
  • count — Total number of scores in the PP+ database.
  • updated — Number of recently updated score entries.

Examples

/pstats count
/pstats updated

/pbpcard — PP+ Best Performance Card List

Aliases: pb, pbplist Fetches a range of PP+ best performance scores and renders them as a card list. This is the PP+ equivalent of /bpcard.
from
integer
required
Starting index of the range.
to
integer
required
Ending index of the range. Specified in [from]-[to] format on QQ.
user
string
Player name.
mode
string
Game mode override.
dimension
string
Filter results by a specific PP+ skill dimension (e.g. flow, aim, speed). Optional.

Examples

/pb 1-21
/pb Aloic 1-21
/pb Aloic 1-21 flow
/pbpcard 1-10

/ppmap — PP vs Time Scatter Plot

Alias: ppmap Draws a scatter plot of the player’s historical BP performance points over time using osu!Track data. Each dot on the chart represents a BP entry at the time it was recorded. Use /update track to refresh the underlying osu!Track data before plotting.
user
string
Player name. Defaults to the caller’s linked account.
mode
string
Game mode override.

Examples

/ppmap
/ppmap Aloic
/ppmap user:Aloic mode:osu

Aliases: rd, recommenddifficulty Returns the recommended star rating range for the player’s next practice maps. The output shows two figures: the standard ppy-algorithm recommendation and an improved variant. Results are returned as a text message.
user
string
Player name. Defaults to the caller’s linked account.
mode
string
Game mode override.

Examples

/rd
/rd Aloic
/rd user:Aloic mode:mania

/maxreading — Max Reading Speed Simulation

Alias: mr Recalculates all 200 BPs with the maximum possible reading bonus (AR approach-rate adjustment) applied and re-ranks them. This isolates how much PP a player could theoretically gain purely from AR manipulation:
  • Maps with no speed mod → DA:AR11
  • Maps with DT / NC → DA:AR10
  • Maps with HT / DC → DA:AR0
  • HD is kept as-is
user
string
Player name.
mode
string
Game mode override.

Examples

/maxreading
/mr Aloic

/noreading — No-Reading Simulation

Alias: nr The inverse of /maxreading. Recalculates all BPs with the reading bonus removed to show baseline PP without any AR advantage:
  • Maps with DT / NC → DA:AR8.5
  • Maps with HT / DC → DA:AR10
  • HD is removed entirely
user
string
Player name.
mode
string
Game mode override.

Examples

/noreading
/nr Aloic

/addscores — Request PP+ Recalculation for a Map

Aliases: addscore, add Submits a beatmap (by BID) to the PP+ calculation service and requests a recalculation of scores on that map. The result returned is the maximum PP+ result found. Only osu! (standard) mode is supported.
bid
integer
required
Beatmap ID to recalculate. osu! standard mode only.
user
string
Player name. Defaults to the caller’s linked account.

Examples

/addscores 4889657
/add Aloic 4889657

/pptest — PP Test Tool

Alias: pptest An internal developer/test utility for verifying PP calculation outputs. It is currently only functional in the test/local execution mode and is not exposed on Discord or QQ production environments.
/pptest is a development-only command and produces no output when run normally on Discord or QQ.

Build docs developers (and LLMs) love