舞萌BOT 命令使用 Wiki
MaiBot 当前版本命令、参数与注意事项
nuym 作者
2026-03-14
更新于 03-21
预计阅读 9 分钟
2498 字
舞萌BOT命令 Wiki
用前须知
- 所有命令都以
/开头,参数之间必须用空格分隔 - 官方 QQ 机器人模式下,通常需要先执行
/绑定QQ <QQ号> - 大多数舞萌相关命令都要求先完成绑定:
/舞萌绑定 <二维码内容> - 命令执行期间会占用用户锁;如果提示“上一条命令仍在处理中”,请等待上一条命令结束
- 改档、同步、跑图、发券、下埋等命令通常会要求等待约 65 秒,请不要在此期间上机或继续操作
免责声明
使用本 BOT 代表你已知晓风险。任何账号相关问题需自行承担后果,开发成员不处理由此产生的问题。
此 BOT 仅用于特定舞萌私服环境调试与数据处理,与其他服务器无关。
最近更新
/舞萌同步和/舞萌发券支持直接附带二维码内容,省去一次单独/扫码/更改队伍等级 <等级>现在会把用户输入的等级真正写入提交数据,范围限制为1-9999/舞萌删分支持曲名、别名和数字 ID,不再只接受数字 ID/舞萌跑图支持不加双引号的完整地图名,并增加模糊搜索- 下埋异常中断或程序重启后,不会再长期卡在“当前在下埋状态”;通常不再需要
/恢复下埋 - 舞萌监控命令只保留状态查询:
/net和/舞萌状态
权限等级
NONE:无需权限或账号绑定NORMAL:普通用户PREMIUM:高级用户ADMIN:管理员
参数约定
<>表示必填参数[]表示可选参数- 布尔值使用
true或false - 二维码内容通常为机台扫出来的完整字符串,常见前缀为
SGWCMAID
基础命令
| 命令 | 说明 | 权限 |
|---|---|---|
/ping | 检测 BOT 是否在线 | NORMAL |
/命令列表 | 查看命令帮助 | NORMAL |
/菜单 | /命令列表 的别名 | NORMAL |
/net | 查看舞萌服务器状态 | NORMAL |
/舞萌状态 | 查看舞萌服务器状态 | NORMAL |
/获取验证码 | 获取站点验证码 | NORMAL |
/jk | 随机发送一张 JK 图片 | NORMAL |
/myid | 查看当前 OpenId 信息 | NORMAL |
登录与绑定
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/绑定QQ <QQ号> | /绑定QQ 123456789 | 官方 QQ 机器人环境下,将机器人侧 UUID 与你的 QQ 关联 | NONE |
/舞萌绑定 <二维码内容> | /舞萌绑定 SGWCMAID... | 绑定舞萌账号 | NONE |
/扫码 <二维码内容> | /扫码 SGWCMAID... | 临时登录机台账号 | NORMAL |
/登录 <二维码内容> | /登录 SGWCMAID... | /扫码 的同义命令 | NORMAL |
/水鱼绑定 <token> | /水鱼绑定 xxxxx | 绑定水鱼查分 token | NORMAL |
/绑定群聊 <群号> | /绑定群聊 123456789 | 在当前群绑定群权限为 PREMIUM | PREMIUM |
/绑定群聊 <群号> <权限> | /绑定群聊 123456789 ADMIN | 管理员手动指定群权限 | ADMIN |
/查看绑定 <QQ号> | /查看绑定 123456789 | 查看指定 QQ 的绑定信息 | ADMIN |
/设置权限 <用户/群> <号码> <权限> | /设置权限 用户 123456789 PREMIUM | 设置用户或群权限 | ADMIN |
/管理员解绑 <QQ号> | /管理员解绑 123456789 | 解除舞萌绑定 | ADMIN |
/解绑openid <OpenId> | /解绑openid xxxxx | 解除 OpenId 绑定 | ADMIN |
/登出 <类型数字> | /登出 2 | 调试用,不建议普通用户使用 | ADMIN |
首次登录时,如果提示需要登录,请使用:
/扫码 <二维码内容>
数据同步与券
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/舞萌预览 | /舞萌预览 | 预览当前账号数据 | NORMAL |
/舞萌同步 | /舞萌同步 | 正常同步数据 | NORMAL |
/舞萌同步 <二维码内容> | /舞萌同步 SGWCMAID... | 直接带二维码同步,省去一次 /扫码 | NORMAL |
/舞萌发券 <倍数数字> | /舞萌发券 6 | 发放指定倍数的券 | NORMAL |
/舞萌发券 <倍数数字> <二维码内容> | /舞萌发券 6 SGWCMAID... | 直接带二维码发券 | NORMAL |
/舞萌查券 | /舞萌查券 | 查看当前券状态 | NORMAL |
/舞萌删券 | /舞萌删券 | 删除当前券 | NORMAL |
/舞萌发券 的倍数目前应使用整数,常见为 2-6。
成绩与下埋
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/舞萌传分 <参数组...> | 见下方 | 上传单条或多条成绩 | PREMIUM |
/舞萌删分 <乐曲ID/曲名/别名> <难度> | /舞萌删分 "INFiNiTE ENERZY -Overdoze-" 紫 | 删除指定成绩 | PREMIUM |
/下埋 <版本> <难度> <连击> <同步> <DX星> | /下埋 祭 紫 app fdxp 5 | 批量下埋上传 | PREMIUM |
/下埋进度 | /下埋进度 | 查看当前下埋任务进度 | PREMIUM |
/恢复下埋 | /恢复下埋 | 兼容保留命令;正常情况下已经不需要依赖它恢复任务 | PREMIUM |
舞萌传分参数
格式:
/舞萌传分 <乐曲ID/别名> <难度> <达成率> <DX分> <连击> <同步> ...
参数说明:
乐曲ID/别名:支持数字 ID、主标题、别名难度:绿/黄/红/紫/白/宴,也支持英文难度名达成率:整数,通常使用服务端要求的原始数值DX分:非负整数连击:如none/fc/fcp/ap/app同步:如none/fs/fsp/fdx/fdxp/sync
支持多曲连续上传,每 6 个参数为一组。
下埋参数
格式:
/下埋 <版本> <难度> <连击> <同步> <DX星>
参数说明:
版本:如真/超/檄/橙/晓/桃/樱/紫/堇/白/雪/辉/熊华/爽煌/宙星/祭祝/双宴/镜难度:绿/黄/红/紫/白/宴连击:如none/fc/fcp/ap/app同步:如none/fs/fsp/fdx/fdxp/syncDX星:0-5
下埋如果因为报错或程序重启中断,现在会直接结束旧任务,不会长期卡住。重新发起新的 /下埋 即可。
角色、伙伴与数值修改
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/设置相同伙伴 <角色ID> | /设置相同伙伴 101001 | 设置相同旅行伙伴 | PREMIUM |
/更改队伍等级 <等级> | /更改队伍等级 10 | 修改当前队伍角色等级,范围 1-9999 | PREMIUM |
/修改亲密度 <搭档ID> <好感度> | /修改亲密度 1234 99999 | 修改搭档亲密度 | PREMIUM |
/修改Rating <Rating> | /修改Rating 16000 | 修改 Rating | PREMIUM |
/修改游玩次数 <当前> <总> | /修改游玩次数 100 9999 | 修改当前和总游玩次数 | PREMIUM |
/舞萌里程 <整数> | /舞萌里程 999999 | 修改里程 | PREMIUM |
/修改地图积累值 <整数> | /修改地图积累值 999999 | 修改地图积累值 | PREMIUM |
/重置版本 | /重置版本 | 重置版本相关状态 | PREMIUM |
段位与课程
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/修改对手难度 <对战等级名> | /修改对手难度 LEGEND | 修改对手难度 | PREMIUM |
/修改段位 <段位名> | /修改段位 将 | 修改课程段位 | PREMIUM |
/设置等级 <对战等级名> | /设置等级 LEGEND | 设置等级称号 | PREMIUM |
/设置升级点数 <整数> | /设置升级点数 9999 | 设置升级点数 | PREMIUM |
收藏、开门与跑图
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/开门 <门名/ID> [发现门] [找到钥匙] [已通关] [观看PV] | /开门 103 true true false false | 万花筒开门 | PREMIUM |
/一键新歌 | /一键新歌 | 批量解锁新歌相关内容 | PREMIUM |
/一键紫白 | /一键紫白 | 批量解锁紫谱和白谱 | PREMIUM |
/添加收藏品 <类型> <物品ID> | /添加收藏品 称号 1234 | 添加收藏品 | PREMIUM |
/舞萌跑图 <地图名称/ID> | /舞萌跑图 Paradigm: Rebootちほー | 跑指定地图并发放地图奖励 | PREMIUM |
跑图说明
- 现在支持直接输入完整地图名,不需要额外加双引号
- 支持模糊搜索;如果名称不完全一致,BOT 会优先尝试相近结果
- 也支持直接输入地图 ID
添加收藏品类型
可用类型包括:
姓名框称号头像礼物歌曲隐藏紫谱白谱宴谱旅行伙伴搭档背景券里程亲密度道具万花筒钥匙
服务器状态
| 命令 | 说明 | 权限 |
|---|---|---|
/net | 查看舞萌服务器状态、延迟、近期状态日志和广播 | NORMAL |
/舞萌状态 | 同 /net | NORMAL |
当前只保留状态查询功能,已经移除了旧的主动上报命令。
管理员通知命令
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/发送通知 <目标> <消息> | /发送通知 123456789 你的券已补发 | 给指定 QQ 或 OpenId 缓存通知 | ADMIN |
/发送公告 <消息> | /发送公告 今晚维护 | 给所有已知用户缓存公告 | ADMIN |
/查看通知 <目标> | /查看通知 123456789 | 查看指定目标的待发送通知 | ADMIN |
/清空通知 <目标> | /清空通知 123456789 | 清空指定目标的待发送通知 | ADMIN |
/清空公告 | /清空公告 | 清空所有公告缓存 | ADMIN |
/更新资源文件 | /更新资源文件 | 更新曲目和别名资源 | ADMIN |
常见问题
1. 提示“请先绑定游戏账号”
先执行:
/舞萌绑定 <二维码内容>
2. 提示“上一条命令仍在处理中”
说明你上一条命令还没结束。请等待当前命令完成后再继续。
3. 下埋中途报错或 BOT 重启了怎么办
现在一般不需要 /恢复下埋。旧任务会终止,直接重新执行 /下埋 即可。
4. /舞萌删分 明明有这首歌却提示找不到
现在已经支持数字 ID、主标题和别名。如果仍然找不到,优先检查:
- 难度是否写对
- 曲名是否包含额外符号或错别字
- 本地资源文件是否需要
/更新资源文件
5. /舞萌跑图 地图名里有空格、冒号或日文怎么办
现在可以直接输入完整地图名,例如:
/舞萌跑图 Paradigm: Rebootちほー
不需要再手动加双引号。
How do you like this post?
Leave a like if it helped you.
