Score Queries
Personal Song Data
Query personal play details for a song, including achievement rate, DX score, FC/FS status.
Command: /info <song ID or name>
| Parameter | Description |
|---|---|
| Song ID or name | Numeric ID or song title/alias |
Add #username to query another player's data.
Examples:
| Command |
|---|
/info 11451 |
/info 11451 #Sakura |
The image includes
- My Scores: when the same account has scores on multiple servers, every server is shown side by side for comparison; a difficulty with no chart on that server shows "no chart".
- Friends: when you add
#username, the other player's scores are compared with yours on your main server difficulty by difficulty, with the achievement gap marked (▲/▼); if they hid their query permission, only "private" is shown.
Score Tolerance
Query the deduction per note type for a given difficulty, the DX score tolerance for each DX star level, and the TAP-error tolerance for each rank.
Command: /scoreline <song ID> [difficulty]
| Parameter | Description | Default |
|---|---|---|
| Song ID | Numeric ID | — |
| Difficulty | green, yellow, red, purple, white | purple |
Examples:
| Command |
|---|
/scoreline 11451 |
/scoreline 11820 white |
The image includes
- DX star: the DX score tolerance required to reach each DX star level.
- Rank tolerance: based on the theoretical 101% baseline, the maximum number of a single TAP Great / TAP Good / TAP Miss error tolerable throughout to still reach each rank (SSS+ / SSS / SS+ / SS / S+ / S); the three tiers are mutually exclusive.
Result Analysis (Read Score)
Send a result screenshot and the bot recognizes the achievement rate and note judgement breakdown, then reconstructs the BREAK sub-breakdown (Just / 50-drop / 100-drop, etc.) along with the per-note achievement loss.
Command: /readscore
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.
The result image includes:
- The matched song, difficulty, DX star level and combo rank (FC / FC+ / AP / AP+)
- A judgement & loss table — each cell shows "count / total loss / loss per note"
- The reconstructed BREAK breakdown; if several mathematically equivalent solutions exist, all of them are listed
Manual Correction Mode
When the image is too compressed and some numbers are misread, call the command without an image and supply the correct values as parameters.
Command: /readscore id=<song ID> ach=<achievement> tap=<CP/P/GR/GD/MS> hold=... slide=... touch=... break=...
| Parameter | Description | Required |
|---|---|---|
id | Numeric song ID | At least one of id or the note breakdown |
ach | Achievement rate, 0–101, e.g. 100.8623 | Yes |
tap / hold / slide / break | The five judgement counts per note type, in CP/P/GR/GD/MS order, separated by / | Yes |
touch | Same format; may be omitted when the chart has no TOUCH notes (treated as all zeros) | Optional |
Parameter names are always in English (ach also accepts acc), and their order does not matter.
Example:
/readscore id=834 ach=100.8623 tap=380/0/0/0/0 hold=52/0/0/0/0 slide=90/0/0/0/0 touch=0/0/0/0/0 break=47/0/1/0/0Improving recognition
- Send the original file whenever possible, and make sure the note breakdown at the top of the game screen is sharp and complete.
- When recognition fails the bot replies with a ready-made command containing the values it did read — copy it, fix the wrong numbers and resend. On Discord you can instead click the "✏️ Fix values" button.
Limitations
- UTAGE charts are not supported.
- If the same note breakdown matches several songs in the database, use
id=to specify the chart.
Chart Statistics
Query AP rate, FC rate, play rate and other statistics for a song's charts.
Command: /rankstats <song ID or name> [region]
| Parameter | Description | Options |
|---|---|---|
| Song ID or name | Numeric ID or title/alias | — |
| Region | Filter by region (optional) | cn, jp, intl |
Examples:
| Command |
|---|
/rankstats 11451 |
/rankstats 11451 jp |
/rankstats 11451 cn |
Recent Plays
View your play history one credit per page (all the songs from one credit). Page 1 is your latest credit.
JP / INTL only
This feature is only available to JP and INTL users.
Command: /recent [page]
Add #username to query another player (requires them to allow score queries).
Examples:
| Command | Description |
|---|---|
/recent | Your latest credit |
/recent 2 | The credit before that; higher numbers go further back |
/recent #Sakura | Sakura's latest credit |
What the image shows
Each song's achievement, rank, and judgment breakdown, with the BREAK breakdown and per-cell losses worked out as in /readscore. The arcade name is shown only when you check your own plays in a private chat.
Records start from your first update
maimai NET keeps only your latest 50 tracks. McMai saves them each time you run /update, so plays from before your first update won't appear. If you play more than 50 tracks between two updates, the older ones are overwritten on NET, and the bot reminds you to update before reaching 50 tracks.
Rating History
View your Rating curve, daily gains, and a record of every Rating-up play.
JP / INTL only
This feature is only available to JP and INTL users. The data comes from your recent plays.
Command: /ralog [range] [page]
Parameters:
| Parameter | Description | Example |
|---|---|---|
| Range | Optional. Defaults to this version (since the latest major version launched). Use 30d for the last N days, or all for all records | 30d |
| Page | Optional. Page 1 is your latest Rating-up plays | 2 |
Range and page can go in either order. Add #username to query another player (requires them to allow score queries).
Examples:
| Command | Description |
|---|---|
/ralog | Rating history for this version |
/ralog 30d | Last 30 days |
/ralog all | All records |
/ralog 30d 2 | Last 30 days, page 2 of Rating-up plays |
TIP
Rating changes not caused by playing, such as a major version switch or constant adjustments, are labeled separately. Gaps in the records are drawn as dashed lines.