Song Search
Search by Title / Alias / ID
Search for songs by title, alias, or ID.
Command: /search <keyword>
Examples:
| Command |
|---|
/search 11451 |
Exact ID Lookup
Query detailed chart info (difficulty, constant, charter, etc.) by song ID.
Command: /id <song ID>
Example:
| Command |
|---|
/id 11451 |
What search and /id results include
- Chart structure: a structure summary of one high-difficulty chart (nine-axis radar, structure constant, main chart tags, and associated charts); the note distribution table also lists each difficulty's structure constant next to its fitted constant. For every difficulty, tap the "Chart Analysis" button or send
/chartanalysis. See Chart Analysis & Practice. - Related charts: the result lists the song's other charts (Standard, DX, UTAGE), each with its ID and level; use
/id <ID>for details. Charts not on your server, or removed from the game, are labeled. If the song has another non-UTAGE chart, platforms with buttons show a button under the result that jumps straight to it. - Multiple matches: when a keyword matches several songs, each candidate ends with its chart type,
[SD]/[DX]/[UTAGE], so you can tell same-named Standard and DX charts apart. - Removed songs: if no server has the song, the bot also searches songs removed from the game and notes that the song is unplayable on every server. Removed songs also work with
/scoreline.
Song Recognition (from Image)
Send a result screenshot and the bot identifies the song in it and returns the chart details — no need to type the title.
Command: /whatsong
How to use:
- Attach a result screenshot together with the command; or
- Reply to a message containing a result screenshot, then mention the bot and send the command.
On success the reply is the same as /search (chart details, chart-confirm button, etc.).
Improving recognition
- Send the original file whenever possible — platforms compress images by default, and compressed screenshots often fail to be recognized.
- The image must contain the full song title panel, otherwise the bot reports that no title was found.
- If a title is recognized but cannot be matched to exactly one song, the recognized text is returned so you can look it up with
/search.
Search by Level Constant
Find songs within a specified constant range, with paging support.
List search results
Constant, BPM, composer, charter, and version searches show results as two-column cards, 16 songs per page: each difficulty's constant is visible at a glance, the difficulties and details matching your query are highlighted, and the version is shown as the game logo. When results run past one page, the image includes a QR code for the McMai song database site, where you can combine filters and sorting.
Command: /dssearch <constant> [page]
| Parameter | Description | Example |
|---|---|---|
| Constant | Single value or range (min-max) | 13.7, 14.0-14.7 |
| Page | Page number (optional, default 1) | 2 |
Examples:
| Command |
|---|
/dssearch 14.0 |
/dssearch 13.7-14.0 |
/dssearch 14.0 2 |
Search by BPM
Find songs within a specified BPM range, with paging support.
Command: /bpmsearch <BPM> [page]
| Parameter | Description | Example |
|---|---|---|
| BPM | Single value or range (min-max) | 180, 160-200 |
| Page | Page number (optional, default 1) | 2 |
Examples:
| Command |
|---|
/bpmsearch 180 |
/bpmsearch 160-200 |
Search by Composer
Search songs by composer / arranger name.
Command: /artistsearch <composer> [page]
Examples:
| Command |
|---|
/artistsearch t+pazolite |
/artistsearch xi 2 |
Search by Charter
Search songs by chart designer name.
Command: /designsearch <charter> [page]
Examples:
| Command |
|---|
/designsearch Jack 2 |
Version Search
Filter songs by game version or release date, with paging support.
Command: /versearch <version keyword> [page]
| Input | Description | Example |
|---|---|---|
new / latest | Songs added in the most recent update for your server | /versearch new |
| Date | Songs released on the specified date (YYYYMMDD or YYYY-MM-DD) | /versearch 2025-01-09 |
| English version name | Songs belonging to the corresponding game version | /versearch circle, /versearch prism |
| Version name substring | Version name keyword (case-insensitive) | /versearch buddies, /versearch 2025 |
Examples:
| Command |
|---|
/versearch new |
/versearch 2025-01-09 |
/versearch circle |
/versearch prism 2 |
Cross-server lookup
If the queried version doesn't exist on your server, the Bot automatically looks it up on other servers and returns those songs. The actual source server is noted above the results.