舞萌BOT 命令使用 Wiki
MaiBot 当前版本命令、参数与注意事项
nuym 作者
2026-03-14
更新于 05-02
预计阅读 10 分钟
2669 字
舞萌BOT命令 Wiki
本文档按当前 MaiBot-V3 代码中的实际注册命令整理。
用前须知
- 所有命令都以
/开头，参数用空格分隔 - 在 QQBot.Net 模式下，首次必须先执行
/绑定QQ <QQ号> - 除
NONE级命令外，命令执行前通常要求已绑定舞萌账号 - 命令执行有并发锁；若提示“上一条命令仍在处理中”，请等待后再发
- 改档、同步、跑图、下埋等命令常见会提示等待约 65 秒，期间不要上机
权限模型
NONE：无需权限NORMAL：普通用户PREMIUM：高级用户ADMIN：管理员
权限判定规则：
- 先看群权限是否满足
- 群权限不满足时，再看用户权限是否满足
- 两者都不满足则返回“权限不足”
别名命令
以下写法会自动映射到主命令：
/help、/菜单、/mai->/命令列表/net、/zlm->/舞萌状态/fq->/舞萌发券/openid->/myid/info->/关于/一键下埋->/下埋
参数约定
<>：必填参数[]：可选参数- 布尔参数使用
true/false - QQ号、群号等数字参数应为纯数字
用户常用命令
基础
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/ping | /ping | 检测 BOT 存活 | NORMAL |
/命令列表 | /命令列表 | 查看帮助 | NORMAL |
/关于 | /关于 | 查看版本/项目信息 | NORMAL |
/舞萌状态 | /舞萌状态 | 查看舞萌服务状态 | NORMAL |
/容错 | /容错 <输入> | 查看输入的容错候选 | NORMAL |
/容错率 | /容错率 <输入> | 查看输入的容错候选 | NORMAL |
/获取验证码 | /获取验证码 | 获取站点验证码 | NORMAL |
/jk | /jk | 随机图片功能 | NORMAL |
/xll | /xll | Pixiv 推荐图片功能 | NORMAL |
/myid | /myid | 查看当前 OpenId 信息 | NORMAL |
绑定与账号
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/绑定QQ <QQ号> | /绑定QQ 123456789 | QQBot.Net 模式绑定 QQ | NONE |
/舞萌绑定 <二维码内容> | /舞萌绑定 SGWCMAID... | 绑定舞萌账号（长期） | NONE |
/扫码 <二维码内容> | /扫码 SGWCMAID... | 临时登录 | NORMAL |
/登录 <二维码内容> | /登录 SGWCMAID... | /扫码 同义命令 | NORMAL |
/水鱼绑定 <token> | /水鱼绑定 xxxxx | 绑定水鱼 token | NORMAL |
/绑定群聊 <群号> | /绑定群聊 123456789 | 在群内绑定该群为 PREMIUM | PREMIUM |
/登出 <类型> | /登出 1 | 调试用登出命令 | ADMIN |
数据与票券
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/舞萌预览 | /舞萌预览 | 预览账号状态 | NORMAL |
/舞萌同步 | /舞萌同步 | 同步成绩到水鱼（需先 /水鱼绑定 <token>） | NORMAL |
/舞萌同步 <二维码内容> | /舞萌同步 SGWCMAID... | 直接使用二维码同步 | NORMAL |
/舞萌发券 <倍数> | /舞萌发券 6 | 发券，倍数范围 2-6 | NORMAL |
/舞萌发券 <倍数> <二维码内容> | /舞萌发券 6 SGWCMAID... | 直接使用二维码发券 | NORMAL |
/舞萌查券 | /舞萌查券 | 查看券信息 | NORMAL |
/舞萌删券 | /舞萌删券 | 清空券库存 | NORMAL |
/获取opt列表 | /获取opt列表 | 查看可用 option 更新包列表 | PREMIUM |
/获取更新包 [文件名] | /获取更新包 SDGB_A071_20260408123929_0.opt | 获取 option 更新包（不填默认最新） | PREMIUM |
成绩与下埋
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/舞萌传分 <参数组...> | 见下方 | 上传单条或多条成绩 | PREMIUM |
/舞萌删分 <乐曲ID/别名> <难度> | /舞萌删分 8 紫 | 删除指定成绩 | PREMIUM |
/下埋 <版本> <难度> <连击> <同步> <DX星> | /下埋 祭祝 紫 app fdxp 5 | 批量下埋任务 | PREMIUM |
/下埋进度 | /下埋进度 | 查看下埋任务进度 | PREMIUM |
/恢复下埋 | /恢复下埋 | 恢复暂停下埋任务 | PREMIUM |
角色与数值
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/设置相同伙伴 <角色ID> | /设置相同伙伴 101001 | 设置旅行伙伴 | PREMIUM |
/更改队伍等级 <等级> | /更改队伍等级 10 | 修改队伍等级 | PREMIUM |
/修改亲密度 <搭档ID> <好感度> | /修改亲密度 1234 99999 | 修改搭档亲密度 | PREMIUM |
/修改Rating <Rating> | /修改Rating 16000 | 修改 Rating | PREMIUM |
/修改游玩次数 <当前> <总> | /修改游玩次数 100 9999 | 修改游玩次数 | PREMIUM |
/舞萌里程 <整数> | /舞萌里程 999999 | 修改里程 | PREMIUM |
/修改地图积累值 <整数> | /修改地图积累值 999999 | 修改地图积累值 | PREMIUM |
/导出设置 | /导出设置 | 导出游戏设置 | PREMIUM |
/导入设置 <Code> | /导入设置 xxxxx | 导入游戏设置 | PREMIUM |
/重置版本 | /重置版本 | 重置版本相关状态 | PREMIUM |
段位与课程
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/修改对手难度 <对战等级名> | /修改对手难度 LEGEND | 修改对手难度 | PREMIUM |
/修改段位 <段位名> | /修改段位 将 | 修改课程段位 | PREMIUM |
/设置等级 <对战等级名> | /设置等级 LEGEND | 设置等级称号 | PREMIUM |
/设置升级点数 <整数> | /设置升级点数 9999 | 设置升级点数 | PREMIUM |
收藏、开门、跑图
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/开门 <门名/ID> | /开门 青门 | 简化开门（默认已发现且有钥匙） | PREMIUM |
/开门 <门名/ID> <发现门> <找到钥匙> <已通关> <观看PV> | /开门 1 true true false false | 完整开门参数 | PREMIUM |
/一键新歌 | /一键新歌 | 批量解锁新歌相关内容 | PREMIUM |
/一键紫白 | /一键紫白 | 批量解锁紫谱/白谱 | PREMIUM |
/添加收藏品 <类型> <物品ID> | /添加收藏品 称号 1234 | 添加收藏品 | PREMIUM |
/删除收藏品 <类型> <物品ID> | /删除收藏品 称号 1234 | 删除收藏品 | PREMIUM |
/舞萌跑图 <地图名称/ID> | /舞萌跑图 1 | 跑图并领取收藏品 | PREMIUM |
管理员命令
| 命令 | 用法 | 说明 | 权限 |
|---|---|---|---|
/绑定群聊 <群号> <权限> | /绑定群聊 123456789 ADMIN | 管理员设置群权限 | ADMIN |
/查看绑定 <QQ号> | /查看绑定 123456789 | 查看绑定信息 | ADMIN |
/管理员解绑 <QQ号> | /管理员解绑 123456789 | 管理员解绑 QQ | ADMIN |
/管理员解绑错误绑定 <QQ号或OpenId> | /管理员解绑错误绑定 123456789 | 解除错误绑定关系 | ADMIN |
/解绑openid <OpenId> | /解绑openid xxxxx | 解绑 OpenId | ADMIN |
/设置权限 <用户/群> <号码> <权限> | /设置权限 用户 123456789 PREMIUM | 设置用户/群权限 | ADMIN |
/更改上限 <群号> <Limit> | /更改上限 123456789 50 | 修改高级群配额上限 | ADMIN |
/重置群聊归附用户 <群号> | /重置群聊归附用户 123456789 | 重置群归附 | ADMIN |
/封禁QQ <QQ号> [原因] | /封禁QQ 123456789 刷屏 | 封禁用户 | ADMIN |
/解封QQ <QQ号> | /解封QQ 123456789 | 解封用户 | ADMIN |
/发送通知 <目标> <消息> | /发送通知 123456789 你的券已补发 | 推送指定通知 | ADMIN |
/发送公告 <消息> | /发送公告 今晚维护 | 推送全局公告 | ADMIN |
/查看通知 <目标> | /查看通知 123456789 | 查看待发送通知 | ADMIN |
/清空通知 <目标> | /清空通知 123456789 | 清空目标通知 | ADMIN |
/清空公告 | /清空公告 | 清空全局公告 | ADMIN |
/更新资源文件 | /更新资源文件 | 更新曲目与别名资源 | ADMIN |
/维修状态 [Mode] [Message] | /维修状态 on 维护中 | 维护模式开关/提示文案 | ADMIN |
/fyh [Mode] | /fyh on | 免验证状态控制 | ADMIN |
/安全关机 | /安全关机 | 安全关闭服务 | ADMIN |
/安全重启 | /安全重启 | 安全重启服务 | ADMIN |
/代理状态 | /代理状态 | 查看代理状态 | ADMIN |
/代理开启 [Target] | /代理开启 All | 开启代理 | ADMIN |
/代理关闭 [Target] | /代理关闭 Mai2 | 关闭代理 | ADMIN |
/代理地址 [Mai2/Chime/All/全部] <Address> | /代理地址 Mai2 http://... | 设置代理地址 | ADMIN |
/代理启动 [Target] | /代理启动 All | 启动代理提供器 | ADMIN |
/代理节点 [Keyword] | /代理节点 hk | 查询节点 | ADMIN |
/代理列表 [Keyword] | /代理列表 jp | 查询节点列表 | ADMIN |
/代理连接 [Mai2/Chime/All/全部] <Node> | /代理连接 All Tokyo-1 | 连接代理节点 | ADMIN |
/代理断开 [Target] | /代理断开 All | 断开代理 | ADMIN |
/代执行 <QQ号> <命令> | /代执行 123456789 舞萌预览 | 以指定用户身份执行命令 | ADMIN |
重点参数说明
二维码内容
- 用于
/舞萌绑定、/扫码、/登录、/舞萌同步 <二维码>、/舞萌发券 <倍数> <二维码> - 应为机台登录二维码原始内容
- 常见前缀为
SGWCMAID - 有效期通常较短，过期需重新获取
/舞萌传分 参数
格式：
/舞萌传分 <乐曲ID/别名> <难度> <达成率> <DX分> <连击> <同步> ...
规则：
- 每 6 个参数为 1 组，可连续多组
难度：绿/黄/红/紫/白/宴或basic/advanced/expert/master/remaster达成率：整数，通常0-102DX分：非负整数连击：none/fc/fcp/ap/app（支持部分中文别名）同步：none/fs/fsp/fdx/fdxp/sync（支持部分中文别名）
/下埋 参数
格式：
/下埋 <版本> <难度> <连击> <同步> <DX星> [Confirm]
规则：
版本支持：真/超/檄/橙/暁/晓/桃/櫻/樱/紫/菫/堇/白/雪/輝/辉/熊华/爽煌/宙星/祭祝/双宴/镜难度：绿/黄/红/紫/白/宴或对应英文名连击：none/fc/fcp/ap/app同步：none/fs/fsp/fdx/fdxp/syncDX星：0-5
/开门 参数
门名支持：青门/白门/紫门/黑门/黄门/赤门/棱镜塔/希望门，也支持门 ID 数字。
完整格式中 4 个布尔参数依次为：
发现门找到钥匙已通关观看PV
/添加收藏品 与 /删除收藏品 类型
可用类型：
姓名框称号头像（或图标）礼物歌曲（或隐藏、乐曲）紫谱（或MAS）白谱（或REM）宴谱（或SRG）旅行伙伴搭档背景券里程亲密度道具万花筒钥匙（或钥匙）
常见报错与处理
权限不足
- 检查当前群权限和你的用户权限
- 某些命令仅
PREMIUM/ADMIN可用
请先绑定游戏账号
- 先执行
/舞萌绑定 <二维码内容>
上一条命令仍在处理中
- 当前用户有命令尚未完成，等待后重试
参数错误 / 解析失败
- 检查空格分隔和参数顺序
- 带空格内容请确认命令是否使用
GreedyString参数 - 当前版本会在多数缺参场景直接提示“还缺少哪些参数”（中文参数名）
- 例如：用户输入
/舞萌传分 1145时，会提示仍缺<难度>、<达成率>、<DX分数>、<连击状态>、<同步状态>
免责声明
使用本 BOT 代表你已知晓风险。账号相关问题请自行承担后果。
How do you like this post?
Leave a like if it helped you.