舞萌BOT 帮助文档-新版

nuym

舞萌BOT命令 Wiki


用前须知

使用BOT默认同意你以知晓风险,任何账号问题开发成员不予处理,你将自行承担带来的风险,最终解释权归 Flora Software 全体开发成员所有。


舞萌绑定和水鱼绑定

舞萌绑定

命令格式:

1
舞萌绑定 [舞萌二维码内容]

操作示例:

1
舞萌绑定 SGWCMAID25114514236F18CDA00A1FDA0BC051E94A10BC80679BBFFD96BC245DB6A94C359DC245C28506A

执行效果:

  • ✅ 成功:返回绑定成功提示并自动撤回消息
  • ❌ 失败:返回具体错误原因(见错误说明)

水鱼绑定

命令格式:

1
水鱼绑定 [你的水鱼TOKEN]

操作示例:

1
水鱼绑定 910080857e531c6f3847f8a527a7608e2ba777fbf42232857db89000d35fc657a7aaed1bb6a817bf8039da23236d295297290b9a918301a686392839f07aa9388

执行效果:

  • ✅ 成功:返回绑定的水鱼用户名并自动撤回消息
  • ❌ 失败:返回错误提示(需先完成舞萌绑定)

⚠️ 绑定规则说明

绑定类型 前提条件 ID格式 唯一性限制
舞萌绑定 无 官方二维码链接 1个QQ仅绑1个舞萌ID
水鱼绑定 需完成舞萌绑定 水鱼网用户名/ID 1个舞萌ID仅绑1个水鱼ID


水鱼ID获取方式

  1. 访问水鱼查分器官网:https://www.diving-fish.com/
  2. 注册/登录账号
  3. 在个人资料页查看TOKEN

绑定要求

  • 必须先完成舞萌绑定
  • 水鱼ID需在水鱼网真实存在

舞萌绑定错误

错误提示 解决方案
⚠️ 绑定格式错误 检查是否包含完整的二维码链接
❌ 解析出的舞萌ID无效 重新获取有效二维码(有效期2分钟)
❌ 您已绑定过舞萌账号 先执行舞萌解绑再重新绑定
❌ 该舞萌ID已被其他账号绑定 确认是否本人账号,或联系管理员处理

水鱼绑定错误

错误提示 解决方案
⚠️ 请先绑定舞萌账号! 先完成舞萌绑定
⚠️ 用户数据异常 重新绑定舞萌账号
❌ 未查到水鱼数据,或者是水鱼网歇菜了~ 检查水鱼ID有效性/等待服务恢复
⚠️ 绑定格式错误 使用正确格式:水鱼绑定 [你的ID]

解绑流程:

1
2
# 解除舞萌绑定(自动解除水鱼绑定)
舞萌解绑

舞萌同步

命令格式

1
舞萌同步

功能说明

将舞萌游戏数据同步到水鱼查分器账户

使用条件

  1. 必须完成舞萌账号绑定
  2. 必须完成水鱼账号绑定
  3. 账户需在最新版本游戏中有游玩记录

错误提示

错误类型 提示信息
未绑定舞萌 ⚠️ 请先绑定舞萌账号!
用户数据异常 ⚠️ 用户数据异常,请重新绑定舞萌账号
未绑定水鱼 ❌ 请先使用命令[水鱼绑定]绑定水鱼账户呀qwp
API执行错误 显示API返回的具体错误信息
加密错误 不是哥们,你到底有没有玩最新最热???
系统异常 ❌ 有神秘bug发生了

成功提示

1
✅ 水鱼账户同步成功!

小黑屋登出

🚪 功能概述

提供舞萌DX机台的小黑屋登出功能,帮助玩家安全退出游戏账号登录状态


登出命令格式

1
2
3
小黑屋
登出小黑屋
登出

(任意一个命令均可触发登出操作)

使用示例:

1
登出小黑屋

⚠️ 前置条件

必须先完成舞萌账号绑定,否则会收到提示:

1
⚠️ 请先绑定舞萌账号!

🚨 错误提示说明

错误提示 原因说明 解决方案
⚠️ 请先绑定舞萌账号! 未完成舞萌账号绑定 先执行舞萌绑定命令
⚠️ 用户数据异常 绑定数据损坏或不完整 重新绑定舞萌账号
❌ 有神秘bug发生了 网络异常或服务器内部错误 稍后重试或联系管理员
❌ [具体错误信息] 舞萌服务器返回的错误 根据提示内容处理

舞萌里程

命令格式

1
舞萌里程 [里程数]

功能说明

修改绑定的舞萌账号里程数值

使用条件

  1. 必须已绑定舞萌账号
  2. 需要高级权限

错误提示

错误类型 提示信息
权限不足 ⚠️ 您没有权限使用此高级命令
未绑定账号 ⚠️ 请先绑定舞萌账号!使用指令:舞萌绑定 [你的舞萌ID]
绑定异常 ⚠️ 您的舞萌ID绑定异常,请重新绑定
参数格式错误 ⚠️ 格式错误,请使用:舞萌里程 [里程数]
非数字输入 ⚠️ 里程数必须符合int规范
系统异常 ❌ 操作失败,请稍后再试
未知错误 ❌ 有神秘bug发生了
API错误 直接显示API返回的错误信息

舞萌发券

命令格式

1
舞萌发券 [券号]

功能说明

向绑定的舞萌账号发放游戏券

使用条件

  1. 必须已绑定舞萌账号
  2. 券号必须是1-6之间的整数

参数说明

参数 说明 取值范围
券号 游戏券类型编号 1-6(整数)

错误提示

错误类型 提示信息
未绑定账号 ⚠️ 请先绑定舞萌账号!使用指令:舞萌绑定 [你的舞萌ID]
绑定异常 ⚠️ 您的舞萌ID绑定异常,请重新绑定
参数格式错误 ⚠️ 发券格式错误,请使用:舞萌发券 [券号]
券号范围错误 ⚠️ 券号必须在1~6之间
非整数输入 ⚠️ 券号必须是1~6之间的整数
操作失败 ❌ 操作失败,请稍后再试
API错误 显示API返回的具体错误信息
系统异常 ❌ 有神秘bug发生了

成功提示

1
✅ 发券成功!券号:[券号]

收藏品管理

命令格式

1
2
添加收藏品 [类型] [物品ID]
删除收藏品 [类型] [物品ID]

功能说明

管理舞萌游戏内的收藏品(解锁/锁定道具)

支持类型

类型名称 对应游戏元素
姓名框 玩家姓名装饰框
称号 游戏内称号
头像 玩家头像图标
礼物 赠送道具
歌曲 解锁乐曲
紫谱 MAS难度谱面
白谱 REM难度谱面
宴谱 SRG难度谱面
角色 游戏角色
搭档 搭档角色
背景 游戏背景
券 游戏券
里程 里程道具
亲密度道具 角色好感度道具
万花筒钥匙 万花筒模式钥匙

使用条件

  1. 必须已绑定舞萌账号
  2. 需要高级权限
  3. 物品ID需为有效数字

错误提示

错误类型 提示信息
参数不足 ⚠️ 参数不足,请使用:添加收藏品/删除收藏品 [类型] [物品ID]
无效类型 ⚠️ 未知的类型: [类型] + 可用类型列表
ID格式错误 ⚠️ 物品ID必须是数字
权限不足 ⚠️ 您没有权限使用此高级命令
未绑定账号 ⚠️ 请先绑定舞萌账号!
绑定异常 ⚠️ 您的舞萌ID绑定异常,请重新绑定
API错误 ❌ 收藏品添加/删除失败: [具体错误]
系统错误 ❌ 系统处理请求时发生错误

成功提示

1
2
✅ 收藏品添加操作成功!类型:[类型] 物品ID:物品ID
✅ 收藏品删除操作成功!类型:[类型] 物品ID:物品ID

舞萌传分

命令格式

1
舞萌传分 [音乐ID] [难度] [达成率] [DX分数] [Combo状态] [Sync状态]

功能说明

上传单次游戏分数

参数说明

参数 说明 格式要求
音乐ID 歌曲标识 数字ID或歌曲别名
难度 谱面难度 绿/basic, 黄/advanced, 红/expert, 紫/master, 白/remaster
达成率 游戏达成率 整数(如975000表示97.50%)
DX分数 DX模式分数 整数
Combo状态 连击达成情况 none/空/n, fc/全连击/fullcombo, fcp/全连击+/fullcombo+, ap/完美无缺/allperfect, app/完美无缺+/allperfect+
Sync状态 同步达成情况 none/空/n, fs/完全同步/fullsync, fsp/完全同步+/fullsync+, fdx/fulldeluxe, fdxp/fulldeluxe+, sync/同步游玩/s

使用条件

  1. 需要高级权限
  2. 必须已绑定舞萌账号

错误提示

错误类型 提示信息
权限不足 ⚠️ 您没有权限使用此高级命令
参数不足 参数不足,正确格式:舞萌传分 [音乐ID] [难度] [达成率] [DX分数] [Combo状态] [Sync状态]
歌曲未找到 ❌ 查不到歌曲
参数为空 ❌ 参数不能为空:难度、Combo状态和Sync状态必须提供
未绑定账号 未绑定,发送 「舞萌绑定 [二维码识别内容]」 绑定
参数格式错误 ❌ 参数错误: [具体错误] + 可用值提示
服务器错误 ❌ 服务器错误: [错误类型]

成功提示

1
✅ 分数上传成功!

舞萌删分

命令格式

1
舞萌删分 [音乐ID] [难度]

功能说明

清除指定歌曲在指定难度下的分数记录(通过上传0分记录实现)

参数说明

参数 说明 格式要求
音乐ID 歌曲标识 数字ID或歌曲别名
难度 谱面难度 绿/basic, 黄/advanced, 红/expert, 紫/master, 白/remaster

使用条件

  1. 需要高级权限
  2. 必须已绑定舞萌账号

错误提示

错误类型 提示信息
权限不足 ⚠️ 您没有权限使用此高级命令
参数不足 参数不足,正确格式:舞萌删分 [音乐ID] [难度]
歌曲未找到 ❌ 查不到歌曲
难度参数为空 ❌ 参数不能为空:难度必须提供
未绑定账号 未绑定,发送 「舞萌绑定 [二维码识别内容]」 绑定
无效难度 ❌ 参数错误: 无效难度 + 可用值提示
加密错误 不是哥们,你到底有没有玩最新最热???
API错误 显示API返回的具体错误信息
服务器错误 ❌ 服务器错误: [错误类型]

成功提示

1
✅ 分数清除成功!

设置相同伙伴和更改队伍等级

命令格式

1
2
设置相同伙伴 [角色ID]
更改队伍等级 [等级]

功能说明

  1. 设置相同伙伴:配置舞萌游戏中相同角色(伙伴)的角色ID
  2. 更改队伍等级:调整舞萌游戏中的队伍等级

使用条件

  1. 需要高级权限
  2. 必须已绑定舞萌账号

参数要求

命令 参数 格式 取值范围
设置相同伙伴 角色ID 整数 无限制
更改队伍等级 等级 整数 1-9999

错误提示

错误类型 提示信息
权限不足 ⚠️ 您没有权限使用此高级命令
参数不足 参数不足,正确格式:设置相同伙伴 [角色ID]
参数不足,正确格式:更改队伍等级 [等级]
未绑定账号 未绑定,发送 “舞萌绑定 [二维码识别内容]” 绑定
等级超限 等级范围应为1-9999
参数格式错误 [参数名]必须是整数
API错误 显示API返回的具体错误信息
系统错误 ❌ 有神秘bug发生了

成功提示

1
2
✅ 已设置相同角色为[角色ID]
✅ 已设置角色等级为 [等级]
  • 标题: 舞萌BOT 帮助文档-新版
  • 作者: nuym
  • 创建于 : 2025-06-18 00:00:00
  • 更新于 : 2025-06-27 20:22:47
  • 链接: https://www.nuym.cn/2025/06/17/maimai-bot-help-wiki-2/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论