Admin and Management Commands

Lazybot includes a set of management commands intended for bot administrators and server operators. Most of these commands require admin privileges enforced by AuthorityVerifier; some are bot-owner-only and rely on hardcoded admin IDs in PermissionChainHandler.

Admin bypass is based on a hardcoded list of user IDs in PermissionChainHandler.adminBypass. Self-hosters must update that list in source code to grant admin access to their own accounts before compiling.

Monitoring & Diagnostics

`/monitor`

Aliases: monitor
Access: Any linked user
Platform: Discord ✓ · QQ ✓ Displays a command usage panel showing how often each Lazybot command has been called. The panel is rendered as an image using the CommandUsage.svg template via RendererDistributor.renderCommandUsage().

/monitor

Use /monitor regularly to identify heavily-used commands or detect unusual activity spikes that might indicate abuse.

`/年度总结` (Annual Summary)

Aliases: 年度总结
Access: Admin
Platform: QQ ✓ Generates an annual activity summary for the bot instance — a year-in-review panel covering command usage statistics. Only available between 14 December and 16 January; calls outside this window return an informational message instead.

/年度总结

The Discord (SlashCommandInteractionEvent) path for /年度总结 has no implemented body in the source. This command is currently available on the QQ/OneBot interface only.

User Management

`/verify`

Aliases: verify
Access: Admin
Platform: QQ ✓ Verifies a user’s osu! account binding against the osu! API. Used to confirm that a linked account is still valid.

target

string

required

The QQ user ID or osu! username to verify.

/verify <username>

The Discord (SlashCommandInteractionEvent) path for /verify has no implemented body in the source. This command is currently available on the QQ/OneBot interface only.

`/li` / `/linkinfo`

Aliases: li, linkinfo
Access: Admin only (enforced by AuthorityVerifier.isAdmin)
Platform: QQ ✓ Look up which osu! account a QQ user ID is currently bound to. Returns the binding summary string from UserBindingPO.toSimpleString().

qq_id

long

required

The QQ user ID to look up. Must be a valid numeric ID.

/li 123456789

Returns the bound osu! username, player ID, default mode, and platform identity. Returns “该用户暂未绑定” if no binding exists.

The Discord (SlashCommandInteractionEvent) path for /li has no implemented body in the source. This command is currently available on the QQ/OneBot interface only.

`/um` (Update Beatmap Background)

Aliases: um
Access: Admin
Platform: QQ ✓ Updates the cached background image for a specific beatmap, identified by its beatmap ID. Accepts a BeatmapParameter (bid) and delegates to manageService.updateBeatmapBackground().

The Discord (SlashCommandInteractionEvent) path for /um has no implemented body in the source. This command is currently available on the QQ/OneBot interface only.

Cache & Data

`/update`

Aliases: update
Access: Any linked user
Platform: Discord ✓ · QQ ✓ Manually refreshes cached data for a user. Useful when a player’s stats have changed and Lazybot’s cache is stale.

type

integer

required

The type of data to refresh:

1 — Player info (rank, PP, statistics)
2 — osuTrack data (BP history)

user

string

The osu! username to update. Defaults to the caller’s linked account.

/update 1
/update 2 Aloic

`/verifymap` / `/vm`

Aliases: verifymap, vm
Access: Admin
Platform: Discord ✓ · QQ ✓ Verifies whether a cached .osu beatmap file for the given BID is stale or missing. Used to maintain the local beatmap cache integrity.

bid

integer

required

The beatmap ID to check.

/vm 1234567

Help

`/help`

Aliases: help
Access: Any user
Platform: Discord ✓ · QQ ✓ Displays the Lazybot help panel — a rendered image (Help.jpg) listing all available commands with short descriptions.

/help

Geometry Dash

`/gdsearch` / `/gdquery` / `/gd查询`

/gdsearch (and its aliases /gdquery, /gd查询) is not currently implemented. The SearchCommand.java source file is entirely commented out and the command is not registered. Do not attempt to use this command — it will not be recognised by the bot.

When this command is eventually implemented, it will search the Geometry Dash demon ladder for levels by name or keyword and return matching level metadata including difficulty, song, and publisher.

Command Reference

Command	Aliases	Access	Description
`/monitor`	monitor	Any user	Command usage stats panel
`/年度总结`	—	Admin	Annual activity summary (QQ only)
`/verify`	verify	Admin	Verify user osu! binding (QQ only)
`/li`	linkinfo	Admin	Look up QQ → osu! binding (QQ only)
`/um`	—	Admin	Update beatmap background cache (QQ only)
`/update`	update	Any user	Refresh cached data
`/verifymap`	vm	Admin	Check beatmap cache validity
`/help`	help	Any user	Display help panel
`/gdsearch`	gdquery, gd查询	Any user	Not implemented — Geometry Dash demon search

osu! Commands

Badge & Card System

Fun & Utilities

Admin and Management Commands

Monitoring & Diagnostics

`/monitor`

`/年度总结` (Annual Summary)

User Management

`/verify`

`/li` / `/linkinfo`

`/um` (Update Beatmap Background)

Cache & Data

`/update`

`/verifymap` / `/vm`

Help

`/help`

Geometry Dash

`/gdsearch` / `/gdquery` / `/gd查询`

Command Reference

Build docs developers (and LLMs) love

osu! Commands

Badge & Card System

Fun & Utilities

Documentation Index

​Monitoring & Diagnostics

​/monitor

​/年度总结 (Annual Summary)

​User Management

​/verify

​/li / /linkinfo

​/um (Update Beatmap Background)

​Cache & Data

​/update

​/verifymap / /vm

​Help

​/help

​Geometry Dash

​/gdsearch / /gdquery / /gd查询

​Command Reference

Build docs developers (and LLMs) love

Monitoring & Diagnostics

`/monitor`

`/年度总结` (Annual Summary)

User Management

`/verify`

`/li` / `/linkinfo`

`/um` (Update Beatmap Background)

Cache & Data

`/update`

`/verifymap` / `/vm`

Help

`/help`

Geometry Dash

`/gdsearch` / `/gdquery` / `/gd查询`

Command Reference