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 provides several commands for viewing and presenting a player’s identity in osu!. From comprehensive profile panels with rank graphs and BP previews, to compact Moelleux-style stat cards and Alivemaster-style YouTube thumbnails, these commands make sharing your osu! achievements visually polished.

/profile — Full Player Profile Panel

Alias: info Displays a detailed player profile panel including global and country rank, total PP, accuracy, play count, top BP preview, and peak rank history. The profile background can be customised with /customize profileBG.
user
string
Player name to display. Defaults to the caller’s linked account.
mode
string
Game mode. Accepted values: osu, taiko, catch / fruits, mania. Defaults to the user’s saved default mode.

Examples

/profile
/info Aloic
/profile user:Aloic mode:taiko

/card — Player Stat Card

Alias: card Generates a compact player card. By default renders in the Moelleux style (a modern, colourful card that automatically derives its accent colour from the player’s profile banner using a hue-detection algorithm). Passing & switches to the classic GameGadget-style card.
user
string
Player name. Defaults to the caller’s linked account.
mode
string
Game mode override.
hue
string
Override the automatic colour detection with a manual hue value (0–360). Format: hue=340. Values outside 0–360 wrap around using modulo.
version
string
Panel style selector (QQ & count):
  • & (1) — Classic GameGadget-style card
  • && (2) — Moelleux style with the BP white overlay disabled
  • &&& (3) — Moelleux style forced to medium contrast
  • &&&& (4) — Moelleux style forced to low contrast

Examples

/card
/card user:Aloic
/card user:Aloic mode:osu
Card styles:
  • Moelleux (default on QQ) — Modern card with dynamic colour palette extracted from the player’s banner image.
  • Classic / GameGadget (& on QQ, or Discord default) — Original compact card layout.
  • BP overlay disabled (&&) — Moelleux without the semi-transparent white mask over the BP section, useful when the banner is dark.
  • Medium contrast (&&&) — Forces medium-contrast text rendering regardless of banner brightness.
  • Low contrast (&&&&) — Forces low-contrast rendering for light backgrounds.
The hue=N parameter overrides the automatic hue picked from the banner image, letting you lock in a specific brand colour.

/oa — osu! Avatar

Alias: avatar Fetches and displays a player’s osu! avatar. Appending & adds a small overlay showing the player’s total PP and global rank alongside the avatar image.
user
string
Player name. Defaults to the caller’s linked account.
version
string
Pass & to include a PP and rank overlay on the avatar image.

Examples

/oa
/oa Aloic
/oa &
/oa Aloic &
If the avatar is out of date, run /update avatar to refresh it from the osu! API before querying /oa.

/customize — Customise Panel Appearance

Alias: customize Modifies your profile panel background or colour theme. Changes persist and apply to all subsequent /profile calls for your account.
type
string
required
Sub-command type. Currently supported values:
  • profileBG — Set a custom background image URL for the /profile panel.
  • profileTheme — Change the colour preset for the profile panel.
Required when type=profileBG. A direct URL to the background image. Recommended resolution: 1900×1000 px. Excess area will be cropped automatically.
Theme
string
Required when type=profileTheme. Colour preset name. Accepted values: Light, Lighter, Dark.

Examples

/customize profileBG https://example.com/mybg.jpg
/customize profileTheme Light
/customize profileTheme Dark

/setmode — Set Default Game Mode

Alias: setmode Updates your saved default game mode. All future commands that have a mode parameter will use this as the fallback when no mode is explicitly provided.
mode
string
required
The mode to set as default. Accepted values: osu / 0, taiko / 1, catch / 2, mania / 3.

Examples

/setmode osu
/setmode taiko
/setmode 3

/setpanel — Set Default Score Panel Style

Alias: sp Saves your preferred score panel style so you don’t need to append & to every command. The stored preference applies to /bp, /rp, /rs, /score, and similar commands.
version
string
required
Panel version number or name. Accepts numeric values and named presets (e.g. marathon).

Examples

/setpanel 1
/sp 2
/sp marathon

/thumbnail — YouTube Thumbnail Generator

Aliases: tns (score-based), tnp (recent-play-based) Generates an Alivemaster-style YouTube video thumbnail from a score or recent play. Parameters must be wrapped in {} braces. tns selects the score by BID (required), while tnp uses the player’s most recent play.
id
integer
Required for tns. Beatmap ID to use as the source score.
u
string
Player username. Defaults to the caller’s linked account.
i
integer
Score index (starting from 1). Defaults to 1.
p
integer
Score placement/position label to display on the thumbnail. Optional.
c
string
Comment text to overlay on the thumbnail. Optional.
attr
string
Beatmap attributes to display. Space-separated list from: ar, od, cs, hp, length, bpm. Defaults to cs ar.

Examples

/tns {id=2570594}
/tns {id=2570594} {u=Aloic} {i=1} {p=123} {attr=ar od cs} {c=Comment Test}
/tnp
/tnp {u=Aloic} {i=2}
All thumbnail parameters use a {key=value} brace syntax rather than the standard slash-command or space-separated format used by other commands.

Build docs developers (and LLMs) love