AWMC QueryBot Basic Tutorial

☕ Support AWMC

All AWMC services are free forever, but keeping them online costs real money. If AWMC has helped you, please consider sponsoring us — every bit of support keeps the services stable. Thank you meow~ 🐾

Account binding, score uploads, PC sync, score queries, and BREAK interactions are now all merged into the same QueryBot — you no longer need to distinguish between the "account bot" and the "query bot". Commands in this page default to no prefix; if your platform configures a prefix such as /, prepend it to each command.

Contact & Feedback

Join the QQ group for discussion: 1072033605.

If something goes wrong, keep the Ref_ID returned by the Bot; admins can use it to inspect the redacted full request chain.

Credential safety

SGWCMAID, official maimai QR links, and score-tracker Tokens are all sensitive credentials. The Bot will try to recall the original message first; if recall fails, please manually recall it immediately and do not forward credentials to others.

0. Quick Start

Follow this order on your first use and you can query scores within five minutes:

1. Add the bot — Click "Add AWMC Bot" at the top of this page, or have a group owner invite the bot to your group. Before using group features, allow the bot to read all messages in group settings (see Section XI).
2. Agree to the terms — Send 用户协议, read the web page, and reply with the full confirmation phrase.
3. Bind your maimai account — Send mai绑定 and submit a SGWCMAID... or official QR link. No Diving Fish / Lxns binding is required to query scores (AWMC NET is the default score database).
4. Query scores — Send b50, ab50, or 我的pc数 to get started; see Command Reference for the full list.
5. Group management & queue cards — Group owners / admins send 群管理 to open the Group Console for feature switches, group stats, arcade queues and weather.

I. First-Time Setup

1. Read and confirm the user agreement

1. Send 用户协议 to the Bot.
2. Open the AWMC maiBot Terms of Service (v4) returned by the Bot.
3. Read the full page carefully and copy the full confirmation phrase from the page.
4. Send the confirmation phrase directly to the Bot; 同意用户协议 <full confirmation phrase> also works.

Only after confirmation can you use account binding, uploads, tickets, BREAK transfers, and lottery features. Sending 撤回用户协议 withdraws consent but does not automatically delete existing account bindings.

Scores, Rating, and trends are anonymized and treated as public data (including training use) by default. To opt out, send 不同意共享我的数据.

2. Bind your maimai account

Send:

mai绑定

The Bot will ask for the latest player QR data. To get it:

1. Open the "maimai DX | CHUNITHM" player QR in WeChat;
2. Long-press the QR and choose "识别图中二维码" (recognize QR in image);
3. Copy the recognized text or web address and send it to the Bot.

The following three forms are supported:

• Full SGWCMAID... string;
• https://wq.wahlap.net/qrcode/img/MAID....png image link;
• https://wq.wahlap.net/qrcode/req/MAID....html request link.

You can also send mai绑定 SGWCMAID... directly. Common alias: maibind.

The Bot verifies the account identity in the QR; after binding it only shows the player name and Rating, never the arcade UID. If the same maimai account exists in old Bot migration records, the new credential automatically claims the old record after verification; BREAK, agreement status, and Lxns OAuth do not transfer with the claim.

After binding verification passes, the Bot automatically syncs anonymized scores to AWMC NET. (the default score database) and prompts that you can register at net.wmc.pub with your QQ email for web queries. This means you don't need to bind Diving Fish or Lxns to query B50 — see the next section.

II. Check Account Status

Send mymai or mai状态 to view:

• Player name, Rating, and old/new version Rating breakdown;
• Friend-battle level, play count, cabinet and data version;
• Recent login, play, co-op, region, and awakening count;
• Account ban status, BREAK balance;
• Diving Fish / Lxns binding, recent uploads, and valid ticket summary.

The status message never shows the full QR, Token, or arcade UID.

The last successfully verified QR is cached for 10 minutes by default. While the cache is valid, the Bot re-verifies the account identity before fetching the latest status; when the cache expires, returns empty/500, the last use failed, or the identity mismatches, the Bot asks for a new QR again. Up to 3 attempts; sending 取消 directly views the saved cached profile.

III. AWMC NET Score Query Without Binding

AWMC NET is QueryBot's built-in default score mirror database (at net.wmc.pub); all new users' default data source is AWMCNET. It lets you query scores without binding any third-party score checker (Diving Fish / Lxns):

1. Complete mai绑定, or directly send the latest SGWCMAID / official QR link;
2. The Bot creates your profile after verification and uploads anonymized scores to AWMC NET;
3. The first successful sync replies: "AWMC NET has synced your info; no further action needed";
4. After that, send b50, ab50, etc. directly — no Diving Fish Token or Lxns OAuth needed.

On the web, register net.wmc.pub with the same QQ email to view scores. AWMC NET only receives anonymized QQ, display name, and scores; it never receives QR codes, arcade UIDs, or third-party Tokens.

Common commands:

Command	Description
数据源	View the current data source (new users default to AWMCNET)
数据源 AWMCNET / 数据源 水鱼 / 数据源 落雪	Switch personal data source
成绩趋势 [days]	AWMC NET server-side Rating trend over the last 30 days, default 30, range 1-365

Aliases: rating趋势, mai趋势, awmc趋势. When AWMC NET has no scores, the Bot automatically detects a bound Diving Fish / Lxns and migrates one score snapshot; some advanced analyses (fitting, gold content, etc.) that Lxns does not support fall back to Diving Fish automatically.

Diving Fish Token and Lxns OAuth are now optional: binding them syncs to the corresponding platform in addition to AWMCNET, convenient for viewing on external score checkers.

IV. Upload Scores to Trackers (Optional)

1. Bind Diving Fish

Get an Import Token from Diving Fish, then send:

mai绑定水鱼 <Token>

Alias: maibindfish <Token>.

2. Bind Lxns

Recommended: send directly:

lxbind

Complete the Lxns OAuth flow as prompted; after that, no Lxns Import Token needs to be submitted to the Bot.

For the compatibility path, send:

mai绑定落雪 <Import Token>

Alias: maibindlx <Import Token>. Uploads prefer OAuth; the Import Token is only used when not authorized or as a compatibility fallback.

3. Upload

Command	What it does	Default price
maiu	Upload to Diving Fish	2 BREAK
maiul	Upload to Lxns	2 BREAK
maiua	Upload to both Diving Fish and Lxns	3 BREAK

All three uploads also write to AWMC NET (always synced); maiu is Diving Fish only, maiul is Lxns only, and maiua is both. External platforms only participate when bound; not binding them does not affect AWMCNET queries.

All three share the "daily first-success-free" allowance. BREAK is only charged after the external service actually returns success; invalid QR, HTTP 500, empty results, task failure, or timeout do not charge.

Uploads prefer the 10-minute verified QR cache. When the cache is unavailable, the Bot asks for the latest SGWCMAID or official link, up to 3 retries; sending 取消 ends the current upload round.

Third-party trackers

QueryBot cannot know when you play at the cabinet or which songs you played. After playing, re-run maiu, maiul, or maiua so the tracker's B50 updates.

V. Sending QR Codes Directly

When a message starting with SGWCMAID or the Wahlap official links above is sent directly, the Bot processes it in this order:

1. Recalls the original credential message first;
2. Verifies the user agreement and group feature switch;
3. Fetches and saves the latest PC data;
4. Auto-uploads by binding status: only Diving Fish bound → Diving Fish, only Lxns bound → Lxns, both bound → both;
5. Returns PC count, upload results, BREAK settlement, and Ref_ID together.

If no score tracker is bound, only PC is synced this time. If the QR is invalid, expired, or the service is temporarily unavailable, you can resend at most 3 times within 3 minutes.

VI. PC Data & Score Queries

Command	Description
更新pc数	Sync PC data using a valid cache or latest QR
我的pc数	Total PC and top 15 most-played charts
pc数 <song>	PC data for a specific song
pc50	B50 sorted by play count
pca50	Rating B50 re-sorted by PC
游玩排行50	Top 50 most-played charts library-wide
pc排行	All synced users' PC total ranking

PC data comes from the maimai account sync; score charts like b50, ab50 still use the Diving Fish or Lxns score checker as the source.

If a query still shows old scores right after an upload, wait a moment and send 刷新b50. The Bot proactively clears the local score cache before and after uploads, but the score checker itself may need time to process.

VII. BREAK

1. Earning & viewing

Command	Description
AWMC签到 / 签到	Daily check-in for BREAK
我的AWMC	Balance, check-in streak, today's usage, recent transactions, and invoice returnCode stats
AWMC帮助	View BREAK rules

The base check-in reward is 1-2 BREAK by default; consecutive check-ins add up to 2 more. Specific groups, Thursdays, and the group's first check-in of the day may apply extra multipliers; the actual result follows what the Bot returns.

2. Default pricing

Feature	Default rule
Score API	First actual request per day free, then 1 BREAK; cache hits are free
B50 analysis	Token base price ×3, min 6, max 60; 6 BREAK reserved before the call, refund/settle difference on success, full refund on failure
Song guessing	Normal correct guess gives 1 BREAK by default; Guess Rating / B50 Impostor settle by rank and difficulty
Score upload	First success per day free, then Diving Fish 2, Lxns 2, both 3
Tickets	First success per day free, then 20 / 30 BREAK
Lottery	2 BREAK per draw by default; 1-10 draws

3. Group interaction

转账BREAK @用户 10
BREAK抽奖
BREAK抽奖 5

BREAK抽奖 draws once by default; a number means consecutive draws. BREAK is an internal interaction currency of the Bot and has no cash value.

VIII. Forum Account Binding (qbind)

qbind links your score-query QQ to your AWMC forum account; after binding you can use check-in, score query, B50, and other account features directly, and the first binding grants 3 BREAK.

1. Start binding

Send:

qbind

Aliases: 论坛绑定 / 绑定qq / mai绑定qq / maiqbind / AWMC论坛绑定.

The Bot returns an AWMC forum OAuth authorization guide:

1. Open the link in a browser and log in to the forum;
2. The forum email must be yourQQ@qq.com (e.g. QQ 123456 → 123456@qq.com);
3. After authorizing, send the authorization link back to the Bot to complete binding.

The authorization code is valid for 10 minutes and can only be used once; act quickly. After qbind is started, you can also send the authorization code or full callback link directly (no need to re-send the qbind prefix).

2. Binding success

On success the Bot replies "论坛绑定成功", showing the forum account, email, and score-query QQ, and tells you that check-in, score query, B50, and other features are now available.

3. Check binding status

Send:

qbind状态

Aliases: 查绑定qq / 我的qbind / 论坛绑定状态 / 论坛账号状态 / 论坛状态.

4. Unbind / cancel

Command	Description
qunbind	Unbind forum/score-query QQ (aliases: 解绑qq / QQ解绑 / 解绑qbind / 解绑论坛 / 论坛解绑)
取消论坛绑定	Cancel an in-progress binding flow (aliases: 论坛绑定取消 / 取消qbind)

INFO

In OneBot mode, the message QQ is the score-query QQ; qbind / forum OAuth is not required to use account features.

IX. Tickets

Send 发票 2 or fp 2 to request a 2x ticket; 2x and 3x are currently supported:

Multiplier	Price after daily first-free
2x	20 BREAK
3x	30 BREAK

Charges only apply after the ticket actually succeeds and is confirmed. mai查票 or 查票 views ticket status by type, stock, and expiry; the reply never shows the maimai account UID or raw API data.

Risk warning

Tickets, uploads, and QR-related features may affect official maimai account safety. Read the AWMC BOT Terms of Service & Privacy Policy in full before use, and bear the risk yourself.

X. FAQ

Bot says "no account record yet"

Complete these in order:

1. Send mai绑定 and submit the latest SGWCMAID string or official link;
2. Send mai绑定水鱼 <Token> as needed, or use lxbind for Lxns OAuth;
3. Use maiu, maiul, maiua to upload to Diving Fish, Lxns, or both.

QR returns 500, all null, or says expired

Go back to the maimai player QR page, regenerate it, and long-press to recognize. Don't keep sending old QR codes; the same round allows at most 3 attempts. If it still fails, restart later.

Bot cannot recall the credential message

Recall it manually immediately. The Bot will still return redacted processing results, but that cannot replace your deleting the original message.

Query says user not found or no data

New users default to AWMC NET; sending one latest SGWCMAID completes sync and enables queries without Diving Fish / Lxns. If you manually switched to Diving Fish, confirm your Diving Fish profile has the correct QQ number, disable "禁止其他人查询我的成绩" (prohibit others from querying my scores), and run maiu at least once; for Lxns, check whether OAuth is still valid.

B50 shows integer scores or differs from the web

Check the Diving Fish privacy settings, disable "对非网页查询的成绩使用掩码" (use mask for non-web query scores), then send 刷新b50 to retry.

Upload says login failed

Usually the QR is expired, the account is still logged in at the cabinet, or the external service is temporarily unavailable. Get a new QR and follow the Bot prompts, up to 3 retries; failed flows never charge BREAK.

Want plain text / weird bot replies

Some clients (certain QQ versions or special environments) cannot render Markdown and quick buttons properly. Send「切换兼容模式」to enable compatibility mode; the Bot replies:

Compatibility mode enabled: except for necessary segments like @, images, and audio, subsequent replies use plain text and links show as raw URLs.

Send「切换兼容模式」or「标准模式」to restore Markdown and quick buttons.

XI. Add the Bot to Your Own Group (Group Owner/Admin)

The Bot supports joining other QQ groups. If you are a group owner or admin and want the Bot to reply without @, play guessing games normally, etc., follow these steps:

1. Open the Bot's profile page and click the settings button at the top right;
2. Change the Bot to "allow viewing all messages". Note: after enabling this, other bots will also read group messages and may cause duplicate replies;
3. Allow the Bot to push messages proactively (required for guessing features);
4. To let the Bot auto-recall messages, add the Bot as an admin in group management.

If issues occur, contact the responsible admin. Midday and evening peaks may be slower; please be patient.

XII. More Commands

• Full Command Reference
• Terms of Service & Privacy Policy
• Terminology